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ES 


fria 


C 编程 指南 


ft C# 程序 内 部 


Hello World -- 您 的 第 一 个 程序 (CH 编程 指南 ) 
CZ 程序 的 通用 结构 (CH 编程 指南 ) 
CH 编码 约定 (CH 编程 指南 ) 


数组 (CH 编程 指南 ) 


作为 对 象 的 数组 (CH 编程 指南 ) 

一 维 数组 (CH 编程 指南 ) 

多 维 数组 (CH 编程 指南 ) 

交错 数组 (CH 编程 指南 ) 

对 数组 使 用 foreach (CH 编程 指南 ) 

将 数组 作为 参数 传递 (C# 编程 指南 ) 
使 用 ref 和 out 传递 数组 (CH 编程 指南 ) 
隐 式 类 型 的 数组 (CH 编程 指南 ) 


类 和 结构 (CH 编程 指南 ) 


X (CH 编程 指南 ) 

对 象 (C# 编程 指南 ) 

结构 (CH 编程 指南 ) 

继承 (CH 编程 指南 ) 

ZAM (CH 编程 指南 ) 

抽象 类 、 密 封 类 及 类 成 员 (C# 编程 指南 ) 
静态 类 和 静态 类 成 员 (CH 编程 指南 ) 
成 员 (CH 编程 指南 ) 

访问 修饰 符 (CH 编程 指南 ) 

字段 (CH 编程 指南 ) 

常量 (C# 编程 指南 ) 

属性 (CH 编程 指南 ) 

方法 (C# 编程 指南 ) 

构造 函数 (CH 编程 指南 ) 

AT MEN (CH 编程 指南 ) 

对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) 
如 何 : 使 用 foreach 访问 集合 类 (CH 编程 指南 ) 
rE RE (CH 编程 指南 ) 

分 部 类 和 方法 (CH 编程 指南 ) 
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匿名 类 型 (CH 编程 指南 ) 1.3.20 
委托 (CH 编程 指南 ) 1.4 
使 用 委托 (C# 编程 指南 ) 1.4.1 
带 有 命名 方法 的 委托 与 带 有 匿名 方法 的 委托 (CH 编程 指南 ) 142 
如 何 : 合并 委托 (多 路 广播 委托 ) (CH 编程 指南 ) 1.4.3 
如 何 : 声明 、 实 例 化 和 使 用 委托 (C# 编程 指南 ) 1.4.4 
枚 举 类 型 (CH 编程 指南 ) 1.5 
事件 (CH 编程 指南 ) 1.6 
如 何 : 订阅 和 取消 订阅 事件 (CH 编程 指南 ) 1.6.1 
如 何 : 发 布 符合 NET Framework 准则 的 事件 (CH 编程 指南 ) 
如 何 : 在 派生 类 中 引发 基 类 事件 (CH 编程 指南 ) 1.6.3 1.6.2 
如 何 : 实现 接口 事件 (CH 编程 指南 ) 1.6.4 
如 何 : 使 用 字典 存储 事件 实例 (CH 编程 指南 ) 1.6.5 
如 何 : 实现 自 定义 事件 访问 器 (CH 编程 指南 ) 1.6.6 
异常 和 异常 处 理 (C# 编程 指南 ) 1.7 
使 用 异常 (C# 编程 指南 ) 1.7.1 
异常 处 理 (C# 编程 指南 ) 1.7.2 
创建 和 引发 异常 (CH 编程 指南 ) 1.7.3 
编译 器 生成 的 异常 (CH 编程 指南 ) 1.7.4 
如 何 : 使 用 try/catch 处 理 异常 (CH 编程 指南 ) 1.7.5 
如 何 : 使 用 finally 执行 清理 代码 (CH 编程 指南 ) 1.7.6 
如 何 : 捕捉 非 CLS 异常 1.7.7 
文件 系统 和 注册 表 (CH 编程 指南 ) 1.8 
如 何 : 循环 访问 目录 树 (CH 编程 指南 ) 1.8.1 
如 何 : 获取 有 关 文 件 、 文 件 夹 和 了 驱动 器 的 信息 (CH 编程 指南 ) 
如 何 : 创建 文件 或 文件 夹 (CH 编程 指南 ) 1.8.3 1.8.2 
如 何 : 复制 、 删 除 和 移动 文件 和 文件 夹 (CH 编程 指南 ) 1.8.4 
如 何 : 提供 文件 操作 进度 对 话 框 (CH 编程 指南 ) 1.8.5 
如 何 : 写 和 人 文本 文件 (CH 编程 指南 ) 1.8.6 
如 何 : 读 取 文本 文件 中 的 内 容 (CH 编程 指南 ) 1.8.7 
如 何 : 一 次 一 行 地 读 取 文本 文件 (Visual C£) 1.8.8 
如 何 : 在 注册 表 中 创建 注册 表 项 (Visual C£) 1.8.9 
泛 型 (C# 编程 指南 ) 1.9 
泛 型 介绍 (CH 编程 指南 ) 1.9.1 
泛 型 的 优点 (CH 编程 指南 ) 1.9.2 
泛 型 类 型 参数 (CH 编程 指南 ) 1.9.3 
类 型 参数 的 约束 (CH 编程 指南 ) 1.9.4 
泛 型 类 (CH 编程 指南 ) 1.9.5 
泛 型 接口 (CH 编程 指南 ) 1.9.6 
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泛 型 方法 (CH 编程 指南 ) 
泛 型 和 数组 (CH 编程 指南 ) 
泛 型 委托 (CH 编程 指南 ) 
泛 型 代码 中 的 默认 关键 字 (CH 编程 指南 ) 
C++ 模板 和 CH 泛 型 之 间 的 区 别 (CH 编程 指南 ) 
运行 时 中 的 泛 型 (C# 编程 指南 ) 
.NET Framework 类 库 中 的 泛 型 (C# 编程 指南 ) 
泛 型 和 反射 〈C# 编程 指南 ) 
泛 型 和 特性 (CH 编程 指南 ) 
索引 器 (CH 编程 指南 ) 
使 用 索引 器 (CH 编程 指南 ) 
接口 中 的 索引 器 (CH 编程 指南 ) 
属性 和 索引 器 之 间 的 比较 (CH 编程 指南 ) 
接口 (CH 编程 指南 ) 
显 式 接口 实现 (CH 编程 指南 ) 


如 何 : 
如 何 : 


显 式 实现 接口 成 员 (CH 编程 指南 ) 
显 式 实 现 两 个 接口 的 成 员 (CH 编程 指南 ) 


互 操 作 性 (CH 编程 指南 ) 
互 操 作 性 概述 (CH 编程 指南 ) 


如 何 
南 ) 


如 何 
如 何 
演练 


: 在 COM 互 操作 编程 中 使 用 索引 属性 (CH 编程 指南 ) 


使 用 平台 调用 播放 波形 文件 (CH 编程 指南 ) 
Office 编程 (C# 和 Visual Basic) 


COM 类 示例 (CH 编程 指南 ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 
查询 表达 式 基 础 (CH 编程 指南 ) 


如 何 : 
: 查询 对 象 集合 (CH 编程 指南 ) 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 


如 何 


在 CH 中 编写 LINQ 查询 


从 方法 中 返回 查询 (CH 编程 指南 ) 

在 内 存 中 存储 查询 结果 (CH 编程 指南 ) 

对 查询 结果 进行 分 组 (CHE 编程 指南 ) 
OERE (CH 编程 指南 ) 

对 分 组 操作 执行 子 查询 (CH 编程 指南 ) 

按 连 续 键 对 结果 进行 分 组 (CH 编程 指南 ) 

在 运行 时 动态 指定 谓词 筛选 器 (CH 编程 指南 ) 
执行 内 部 联接 〈C# 编程 指南 ) 

执行 分 组 联接 (CH 编程 指南 ) 
执行 左 外 部 联接 (CH 编程 指南 ) 


1.9.7 
1.9.8 
1.9.9 
1.9.10 
1.9.11 
1.9.12 
1.9.13 
1.9.14 
1.9.15 
1.10 
1.10.1 
1.10.2 
1.10.3 
1.11 
1.11.1 
1.11.2 
1.11.3 
1.12 
1.12.1 


: 通过 使 用 Visual C# 功能 访问 Office 互 操作 对 象 (CH 编程 指 


1.12.2 
1.12.3 
1.12.4 
1.12.5 
1.12.6 
1.13 
1.13.1 
1.13.2 
1.13.3 
1.13.4 
1.13.5 
1.13.6 
1.13.7 
1.13.8 
1.13.9 
1.13.10 
1.13.11 
1.13.12 
1.13.13 
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如 何 : 
如 何 : 
如 何 : 
如 何 : 
如 何 : 


xt Join 子 句 的 结果 进行 排序 (CH 编程 指南 ) 
使 用 复合 键 进行 联接 (CH 编程 指南 ) 
执行 自 定义 联接 操作 (CH 编程 指南 ) 

在 查询 表达 式 中 义理 Null 值 (CH 编程 指南 ) 
在 查询 表达 式 中 处 理 异常 (CH 编程 指南 ) 


Main() 和 命令 行 参数 (CH 编程 指南 ) 
命令 行 参数 (CH 编程 指南 ) 


如 何 : 
如 何 : 


显示 命令 行 参数 (CH 编程 指南 ) 
使 用 foreach 访问 命令 行 参数 (CH 编程 指南 ) 


Main() 返回 值 (C# 编程 指南 ) 
命名 空间 (CH 编程 指南 ) 
使 用 命名 空间 (CH 编程 指南 ) 


如 何 : 
如 何 : 


使 用 全 局 命名 空间 别名 (CH 编程 指南 ) 
使 用 My 命名 空间 (C# 编程 指南 ) 


可 以 为 null 的 类 型 (CH 编程 指南 ) 
使 用 可 以 为 null 的 类 型 (CH 编程 指南 ) 
装 箱 可 以 为 null 的 类 型 (C# 编程 指南 ) 


如 何 : 
如 何 : 


标识 可 以 为 null 的 类 型 (CH 编程 指南 ) 
安全 地 将 bool? 强制 转换 为 bool (C£ 编程 指南 ) 


语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 
语句 (CH 编程 指南 ) 
表达 式 (CH 编程 指南 ) 
运算 符 (C# 编程 指南 ) 
匿名 函数 (CH 编程 指南 ) 
可 重 载运 算 符 (C# 编程 指南 ) 
转换 运算 符 (C# 编程 指南 ) 


如 何 : 


使 用 运算 符 重 载 创建 复数 类 (CH 编程 指南 ) 


相等 比较 (CH 编程 指南 ) 
字符 串 (CH 编程 指南 ) 


如 何 : 
: 修改 字符 串 内 容 (CH 编程 指南 ) 


如 何 


如 何 : 
如 何 : 
如 何 : 
如 何 : 
: 确定 字符 串 是 否 表 示 数 值 (CH 编程 指南 ) 
如 何 : 
如 何 : 


如 何 


如 何 


PROTEUS (CH 编程 指南 ) 


RFR (CH 编程 指南 ) 
拆 分 字符 串 (CH 编程 指南 ) 
使 用 字符 串 方 法 搜索 字符 串 〈《C# 编程 指南 ) 
使 用 正则 表达 式 搜 索 字 符 串 〈《C# 编程 指南 ) 


将 字符 串 转 换 为 DateTime (CZ 编程 指南 ) 
在 旧式 编码 与 Unicode 之 间 转 换 (CH 编程 指南 ) 
将 RTF 转换 为 纯 文 本 (CH 编程 指南 ) 
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类 型 (CH 编程 指南 ) 1.19 
强制 转换 和 类 型 转换 (CH 编程 指南 ) 1.19.1 
装 箱 和 取消 装 箱 (CH 编程 指南 ) 1.19.2 
使 用 类 型 dynamic (C# 编程 指南 ) 1.19.3 
如 何 : 使 用 as 和 is 运算 符 安全 地 进行 强制 转换 (C# 编程 指南 ) 

如 何 : 将 字 节 数组 转换 为 int (CH 编程 指南 ) 1.19.5 1.19.4 
如 何 : 将 字符 串 转 换 为 数字 (CH 编程 指南 ) 1.19.6 
如 何 : 在 十 六 进 制 字 符 串 与 数值 类 型 之 间 转 换 (CH 编程 指南 ) 

不 安全 代码 和 指针 (C# 编程 指南 ) 1.20 1.19.7 
固定 大 小 的 缓冲 区 (CH 编程 指南 ) 1.20.1 
指针 类 型 (CH 编程 指南 ) 1.20.2 

XML 文档 注释 (CH 编程 指南 ) 1.21 
建议 的 文档 注释 标记 (CH 编程 指南 ) 1.21.1 
处 理 XML 文件 (C£ 编程 指南 ) 1.21.2 
文档 标记 的 分 隔 符 (CH 编程 指南 ) 1.21.3 
如 何 : 使 用 XML 文档 功能 (CH 编程 指南 ) 1.21.4 

C# 参考 2 

C# 关键 字 2.1 
类 型 (C# 参考 ) 24.1 
值 类 型 (CH 参考 ) 212 
bool (C£ 2) 2.1.3 
byte (C£ 参考 ) 2.14 
char (C£ 参考 ) 2.1.5 
decimal (C£ 参考 ) 2.1.6 
double (C£ 2) 2.1.7 
enum (C£ 2) 2.1.8 
float (C£ £2) 2.1.9 
int (C£ 参考 ) 2.1.10 
long (C£ 参考 ) 2.1.11 
sbyte (C£ 2) 2.1.12 
short (C£ 2) 2.1.13 
struct (C£ 2) 2.1.14 
uint (C£ £2) 2.1.15 
ulong (C£ 2X) 2.1.16 
ushort (C£ 参考 ) 2.1.17 
引用 类 型 (CH 参考 ) 2.1.18 
class (C# 参考 ) 2.1.19 
委托 (CK 参考 ) 2.1.20 
dynamic (C£ 参考 ) 2.1.21 
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接口 (C# 参考 ) 

object (C# 参考 ) 

string (C# 参考 ) 

内 插 字符 串 (C£ 和 Visual Basic 引用 ) 
void (C# 参考 ) 

var (C# 参考 ) 

类 型 参考 表 (C# 参考 ) 

内 置 类 型 表 (CH 参考 ) 

整 型 表 (CH 参考 ) 

浮 点 型 表 (CHA) 

默认 值 表 (CH 参考 ) 

值 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 

显 式 数值 转换 表 (CH 参考 ) 
设置 数值 结果 表 的 格式 (CARS) 
修饰 符 (CH 参考 ) 

i mess (CH 参考 ) 

可 访问 性 级 别 (C£ 参考 ) 
可 访问 域 (CH 参考 ) 

可 访问 性 级 别 的 使 用 限制 (CH 参考 ) 
internal (C£ 参考 ) 

private (C# 参考 ) 

protected (Cit 参考 ) 

public (C& 参考 ) 

abstract (C£ 参考 ) 

async (C£ 参考 ) 

const (C# 参考 ) 

event (C£ 参考 ) 

extern (C£ 参考 ) 

in 〈 泛 型 修饰 符 ) (CH 参考 ) 
out 〈 泛 型 修饰 符 ) (CK 参考 ) 
override (C# 参考 ) 

readonly (C£ 参考 ) 

sealed (C£ 参考 ) 

static (CK 参考 ) 

unsafe (C# 参考 ) 

virtual (C£ 参考 ) 

volatile (C£ 参考 ) 

语句 关键 字 (CH 参考 ) 
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选择 语句 (CH BS) 
if-else (C# 参考 ) 

switch (C£ 参考 ) 

迭代 语句 (CR 参考 ) 

do (C£ 参考 ) 

for (C# 参考 ) 

foreach, in (C# 参考 ) 
while (C& 参考 ) 

跳 转 语句 (CH 参考 ) 
break (C# 参考 ) 
continue (C£ 参考 ) 

goto (C# 参考 ) 

return (C£ 参考 ) 
异常 处 理 语句 (C# 参考 ) 
throw (C£ 参考 ) 
try-catch (C£ 参考 ) 
try-finally (C# 参考 ) 
try-catch-finally (C£ 参考 ) 
Checked 和 Unchecked (C# 参考 ) 
checked (C# 2) 
unchecked (C£ 参考 ) 
fixed 语句 (C£ 参考 ) 
“锁定 "语句 (CH 参考 ) 
方法 参数 (CH 参考 ) 
params (C£ 参考 ) 

ref (CH 参考 ) 

out (C£ 参考 ) 

out 参数 修饰 符 (CH 参考 ) 
命名 空间 关键 字 (CH 参考 ) 
命名 空间 (C# 参考 ) 
using (C£ 参考 ) 

using 指令 (CH 参考 ) 
using 语句 (C4 2) 

外 部 别名 (CH 参考 ) 
运算 符 关 键 字 (CH 参考 ) 
as (C# 参考 ) 

await (C£ 参考 ) 

is (C# 参考 ) 

new (C£ 2) 
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new 运算 符 (CH SS) 
new 修饰 符 (CH 参考 ) 
new 约束 (CH 参考 ) 
sizeof (C# 参考 ) 

typeof (C# 参考 ) 

true (C£ 参考 ) 

true 运算 符 (CH 参考 ) 
true 字面 常数 (CH 参考 ) 
false (C£ 参考 ) 

false 运算 符 (CH 参考 ) 
false 字面 常数 (C# 参考 ) 
stackalloc (C# 2) 
nameof (C# 和 Visual Basic 引用 ) 
转换 关键 字 (CH 参考 ) 
explicit (C£ 参考 ) 
implicit (C£ 参考 ) 
运算 符 (C# 参考 ) 

访问 关键 字 (CH 参考 ) 
base (CK 参考 ) 

this (C£ 参考 ) 

文字 关键 字 (CH 参考 ) 
null (C£ 参考 ) 

default (C# 参考 ) 

上 下 文 关键 字 〈C# 参考 ) 
add (C£ 参考 ) 

get (C# 参考 ) 

global (C# 参考 ) 

分 部 (类 型 ) (CK 参考 ) 
分 部 (方法 ) (CRX) 
remove (C# 参考 ) 

set (C# 参考 ) 

where ( 泛 型 类 型 约束 ) (CHES) 
value (C# 参考 ) 

yield (C£ 参考 ) 

查询 关键 字 (CH 参考 ) 
from 子 句 (C# 参考 ) 
where 子 句 (CH 参考 ) 
select 子 句 (CH 参考 ) 
group ^ (CH 参考 ) 


2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1; 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
2.1. 
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into (C£ 参考 ) 

orderby F (CH 参考 ) 
join 子 句 (C4 参考 ) 

let 子 句 (CH 参考 ) 
ascending (C£ 参考 ) 
descending (C£ 参考 ) 
on (C# 参考 ) 

equals (C£ 参考 ) 

by (C£ 参考 ) 

in (C£ 参考 ) 


C# 运算 符 


运算 符 (C# 参考 ) 

() 运算 符 (CR 参考 ) 
.运算 符 (CH 参考 ) 

:: 运算 符 (CH 参考 ) 

+ 运算 符 (CHA) 
-运算 符 (CH 参考 ) 

* 运算 符 (C# 参考 ) 
/运算 符 (C4 参考 ) 

% 运算 符 (CH 参考 ) 

& 运算 符 (CR 参考 ) 

| 运算 符 (CH 参考 ) 

^ 运 算 符 (C# 参考 ) 

! 运算 符 (CH 参考 ) 

~ 运算 符 (C# 参考 ) 

= 运算 符 (CES) 

&lt; 运算 符 (CR 参考 ) 
&gt 运算 符 (CH 参考 ) 
?: 运算 符 (C# 参考 ) 

++ 运算 符 (CHESS) 

-- 运算 符 (CH 参考 ) 

&& zB (C# 参考 ) 

| 上 | 运算 符 (C# 参考 ) 
&lt;&lt; 运算 符 〈C# 参考 ) 
&gt;&gt; ZAR (CH 参考 ) 
== 运算 符 (C# 参考 ) 

!= 运算 符 (C# 参考 ) 
&lt;= 运算 符 (C# 参考 ) 
&gt;= 运算 符 (C# 参考 ) 
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+= 运算 符 〈C# SS) 2.2.29 
-= 运算 符 (CH 参考 ) 2.2.30 
*= 运算 符 〈C# 参考 ) 2.2.31 
/= 运算 符 〈C# 参考 ) 2.2.32 
%= 运算 符 〈C# 参考 ) 2.2.33 
&- 运算 符 (CH 参考 ) 2.2.34 
|= 运算 符 (CX 参考 ) 2.2.35 
^= 运算 符 〈C# 参考 ) 2.2.36 
&lt;&lt;= 运算 符 (CH 参考 ) 2.2.37 
&gt;&gt;= 运算 符 〈C# 参考 ) 2.2.38 
-&gt; 运算 符 〈C# 参考 ) 2.2.39 
?? 运算 符 (C# 参考 ) 2.2.40 
=&gt 运算 符 (CH SS) 2.2.41 
NULL 条 件 运 算 符 (C# 和 Visual Basic) 2.2.42 
CH 预 处 理 器 指令 2.3 
Hif (CH 参考 ) 2.3.1 
Helse (C# 参考 ) 2.3.2 
#elif (C# 参考 ) 2.3.3 
#endif (C£ 参考 ) 2.3.4 
#define (C£ 参考 ) 2.3.5 
#undef (C£ 参考 ) 2.3.6 
#warning (C£ 参考 ) 2.3.7 
#error (C£ 2) 2.3.8 
Aline (C# 参考 ) 2.3.9 
Zregion (C£ 参考 ) 2.3.10 
#endregion (C£ 2) 2.3.11 
#pragma (C£ 2) 2.3.12 
#pragma warning (C£ 2) 2.3.13 
#pragma checksum (C£ 参考 ) 2.3.14 
C£ Compiler Options 2.4 
Command-line Building With csc.exe 2.4.1 
How to: Set Environment Variables for the Visual Studio Command 
Line 2.4.2 
Deployment of C£ Applications 2.4.3 
CZ Compiler Options Listed by Category 2.4.4 
C£ Compiler Options Listed Alphabetically 2.4.5 
(à (C£ Compiler Options) 2.4.6 
/addmodule (C£ Compiler Options) 2.4.7 


lappconfig (C£ Compiler Options) 2.4.8 
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/baseaddress (C£ Compiler Options) 2.4.9 
/bugreport (C£ Compiler Options) 2.4.10 
[checked (C£ Compiler Options) 2.4.11 
/codepage (C£ Compiler Options) 2.4.12 
[debug (C£ Compiler Options) 2.4.13 
[define (C£ Compiler Options) 2.4.14 
/delaysign (C£ Compiler Options) 2.4.15 
/doc (C£ Compiler Options) 2.4.16 
lerrorreport (C£ Compiler Options) 2.4.17 
/filealign (C# Compiler Options) 2.4.18 
/fullpaths (C£ Compiler Options) 2.4.19 
/help, /? (C£ Compiler Options) 2.4.20 
/highentropyva (C£ Compiler Options) 2.4.21 
/keycontainer (C£? Compiler Options) 2.4.22 
/keyfile (C£ Compiler Options) 2.4.23 
/langversion (C£ Compiler Options) 2.4.24 
Nib (C£ Compiler Options) 2.4.25 
link (C£ Compiler Options) 2.4.26 
llinkresource (C£ Compiler Options) 2.4.27 
[main (C£ Compiler Options) 2.4.28 
/moduleassemblyname (C£ Compiler Option) 2.4.29 
/noconfig (C£ Compiler Options) 2.4.30 
/nologo (C£ Compiler Options) 2.4.31 
/nostdlib (C£ Compiler Options) 2.4.32 
/nowarn (C£ Compiler Options) 2.4.33 
/nowin32manifest (C# Compiler Options) 2.4.34 
loptimize (C£ Compiler Options) 2.4.35 
/out (C£ Compiler Options) 2.4.36 
/pdb (C£ Compiler Options) 2.4.37 
[platform (C£ Compiler Options) 2.4.38 
/preferreduilang (C£? Compiler Options) 2.4.39 
/recurse (C£ Compiler Options) 2.4.40 
/reference (C# Compiler Options) 2.4.41 
/resource (C£ Compiler Options) 2.4.42 
/subsystemversion (C£ Compiler Options) 2.4.43 
/target (C£ Compiler Options) 2.4.44 
/target:appcontainerexe (CX 编译 器 选项 ) 2.4.45 
/target:exe (C£ Compiler Options) 2.4.46 
/target:library (C£ Compiler Options) 2.4.47 
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/target:module (C£ Compiler Options) 2.4.48 
/target:winexe (C# Compiler Options) 2.4.49 
/target:winmdobj (C# 编译 器 选项 ) 2.4.50 
/unsafe (C£ Compiler Options) 2.4.51 
lutf8output (C£ Compiler Options) 2.4.52 
/warn (C£ Compiler Options) 2.4.53 
/warnaserror (C£ Compiler Options) 2.4.54 
/win32icon (C£ Compiler Options) 2.4.55 
/win32manifest (C£ Compiler Options) 2.4.56 
/win32res (C£ Compiler Options) 2.4.57 
C£ Compiler Errors 2.5 
Compiler Error CS0001 2.5.1 
Compiler Error CS0006 2.5.2 
Compiler Error CS0007 2.5.3 
编译 器 错误 CS0015 2.5.4 
Compiler Error CS0016 2.5.5 
Compiler Error CS0019 2.5.6 
Compiler Error CS0029 2.5.7 
Compiler Error CS0034 2.5.8 
Compiler Error CS0038 2.5.9 
Compiler Error CS0039 2.5.10 
Compiler Error CS0050 2.5.11 
Compiler Error CS0051 2.9.12 
Compiler Error CS0052 2.5.13 
Compiler Error CS0071 2.5.14 
Compiler Error CS0103 2:5.15 
Compiler Error CS0106 2.5.16 
Compiler Error CS0115 2.9.17 
Compiler Error CS0116 2.5.18 
Compiler Error CS0120 2.5.19 
Compiler Error CS0122 2.5.20 
Compiler Error CS0134 2.5.21 
Compiler Error CS0151 2.9.22 
编译 器 错误 CS0163 2.5.23 
Compiler Error CS0165 2.5.24 
Compiler Error CS0173 2.5.25 
Compiler Error CS0178 2.5.26 
Compiler Error CS0188 2.5.27 
Compiler Error CS0201 2.5.28 


13 


MSDN CZ 编程 指南 & 参考 手册 2015 


Compiler Error CS0229 2.5.29 
Compiler Error CS0233 2.5.30 
Compiler Error CS0234 2.5.31 
Compiler Error CS0246 2.9.92 
Compiler Error CS0260 2.5.33 
Compiler Error CS0266 2.5.34 
Compiler Error CS0269 2.5.35 
Compiler Error CS0270 2.5.36 
Compiler Error CS0304 2.5.37 
Compiler Error CS0310 2.5.38 
Compiler Error CS0311 2.5.39 
Compiler Error CS0413 2.5.40 
Compiler Error CS0417 2.5.41 
Compiler Error CS0433 2.5.42 
Compiler Error CS0445 2.5.43 
Compiler Error CS0446 2.5.44 
Compiler Error CS0504 2.5.45 
编译 器 错误 CS0507 2.5.46 
Compiler Error CS0518 2.5.47 
Compiler Error CS0523 2.5.48 
Compiler Error CS0545 2.5.49 
Compiler Error CS0552 2.5.50 
Compiler Error C80563 2.5.51 
Compiler Error CS0570 2.5.52 
Compiler Error CS0571 2.5.53 
Compiler Error C80579 2.5.54 
Compiler Error CS0592 2.5.55 
Compiler Error CS0616 2.5.56 
Compiler Error CS0650 2.5.57 
Compiler Error CS0686 2.5.58 
Compiler Error CS0702 2.5.58 
编译 器 错误 CS0703 2.5.60 
Compiler Error CS0731 2.5.61 
Compiler Error C80826 2.5.62 
Compiler Error CS0834 2.5.63 
Compiler Error CS0840 2.5.64 
编译 器 错误 CS0843 2.5.65 
Compiler Error CS0845 2.5.66 
Compiler Error CS1001 2.5.67 
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Compiler Error CS1009 2.5.68 
Compiler Error CS1018 2.5.69 
Compiler Error CS1019 2.5.70 
Compiler Error CS1026 2.5.71 
Compiler Error CS1029 2.5.72 
Compiler Error CS1061 2.5.73 
Compiler Error CS1112 2.5.74 
编译 器 错误 CS1501 2.5.75 
Compiler Error CS1502 2.5.76 
Compiler Error CS1519 2.5.77 
Compiler Error CS1540 2.5.78 
Compiler Error CS1546 2.5.79 
Compiler Error CS1548 2.5.80 
Compiler Error CS1564 2.5.81 
Compiler Error CS1567 2.5.82 
Compiler Error CS1579 2.5.83 
Compiler Error CS1612 2.5.84 
Compiler Error CS1614 2.5.85 
Compiler Error CS1640 2.5.86 
Compiler Error CS1644 2.5.87 
Compiler Error CS1656 2.5.88 
Compiler Error CS1674 2.5.89 
Compiler Error CS1703 2.5.90 
Compiler Error CS1704 2.5.91 
Compiler Error CS1705 2.5.92 
Compiler Error CS1708 2.5.93 
Compiler Error CS1716 2.5.94 
编译 器 错误 CS1721 2.5.95 
Compiler Error CS1726 2.5.96 
Compiler Error CS1729 2.5.97 
Compiler Error CS1919 2.5.98 
Compiler Error CS1921 2.5.99 
Compiler Error CS1926 2.5.100 
Compiler Error CS 1933 2.5.101 
Compiler Error CS1936 2.5.102 
Compiler Error CS1941 2.5.103 
Compiler Error CS1942 2.5.104 
Compiler Error CS1943 2.5.105 
Compiler Error CS1946 2.5.106 
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编译 器 错误 CS2032 2.5.107 
Compiler Warning (level 1) CS0420 2.5.108 
Compiler Warning (level 1) CS0465 2.5.109 
Compiler Warning (level 1) CS1058 2.5.110 
Compiler Warning (level 1) CS1060 2.5.111 
Compiler Warning (level 1) CS1598 2.5.112 
Compiler Warning (level 1) CS1607 2.5.113 
Compiler Warning (level 1) CS1616 2.5.114 
Compiler Warning (level 1) CS1658 2.5.115 
Compiler Warning (level 1) CS1683 2.5.116 
Compiler Warning (level 1) CS1685 2.5.117 
Compiler Warning (level 1) CS1690 2.5.118 
Compiler Warning (level 1) CS1691 2.5.119 
Compiler Warning (level 1) CS1699 2.5.120 
Compiler Warning (level 1) CS1762 2.5.121 
Compiler Warning (level 1) CS1956 2.5.122 
Compiler Warning (level 1) CS3003 2.5.123 
Compiler Warning (level 1) CS3007 2.5.124 
Compiler Warning (level 1) CS3009 2.5.125 
编译 器 警告 (等 级 1) CS4014 2.5.126 
Compiler Warning (level 2) CS0108 2.5.127 
编译 器 警告 (等 级 2) CS0467 2.5.128 
Compiler Warning (level 2) CS0618 2.5.129 
Compiler Warning (level 2) CS1701 2.5.130 
Compiler Warning (level 3) CS0675 2.9.1231 
Compiler Warning (level 3) CS1700 2.5.132 
Compiler Warning (level 4) CS0429 2.9.1233 
Compiler Warning (level 4) CS1591 2.5.134 
Compiler Warning (level 4) CS1610 2.9.135 
Ci 语言 规范 2.6 
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CH 编程 指 雨 
本 节 提 供 有 关 关 键 的 CH 语言 功能 和 CH 可 通过 .NET Framework 访问 的 功能 的 详 
细 信 息 。 


本 节 中 大 部 分 内 容 都 假定 您 已 了 解 有 关 CH 和 一 般 编程 概念 的 一 些 知识 。 如 果 您 刚 
开始 学 习 编 程 或 C#， 您 可 能 还 希望 访问 C# Developer Center (CH 开发 人 员 中 
心 ) ， 此 处 提供 很 多 教程 、 示 例 和 视频 ， 可 帮助 您 入 门 。 


有 关 特 定 的 关键 字 、 Le 使 的 信息 ， 请 参见 C# 参考 。 有 关 C# 语 
BASEN EAR hs 4 参见 A, CH i 2S MB. 


ERD 

在 CH 程序 内 部 

Main() 和 命令 行 参 数 (CH 编程 指南 ) 
类 型 (CH 编程 指南 ) 

数组 (CH 编程 指南 ) 

SRR (CH 编程 指南 ) 

语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 
类 和 结构 (CH 编程 指南 ) 

属性 (C# 编程 指南 ) 

接口 (C# 编程 指南 ) 

索引 器 (CH 编程 指南 ) 

枚 举 类 型 (CH 编程 指南 ) 

委托 (CH 编程 指南 ) 

事件 (CH 编程 指南 ) 

泛 型 (C# 编程 指南 ) 

迭代 器 (C# 和 Visual Basic) 

LINQ 查询 表达 式 (CH 编程 指南 ) 
Lambda 表达 式 (CH 编程 指南 ) 
命名 空间 (CH 编程 指南 ) 

可 以 为 null 的 类 型 (Cft 编程 指南 ) 


ol 


^ LI > JO LE = 二 A 
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不 安全 代码 和 指针 (CH 编程 指南 ) 
XML 文档 注释 (CH 编程 指南 ) 


平台 部 分 

Application Domains (C£ and Visual Basic) 
程序 集 和 全 局 程序 集 缓存 (C# 和 Visual Basic) 
特性 (C# 和 Visual Basic) 

集合 (C# 和 Visual Basic) 

异常 和 异常 处 理 (C# 编程 指南 ) 
文件 系统 和 注册 表 (CH 编程 指南 ) 

互 操作 性 (CH 编程 指南 ) 

反射 (C# 和 Visual Basic) 


重要 章节 


http://go.microsoft.com/fwlink/?Linkld=195406 
http://go.microsoft.com/fwlink/?Linkld=195407 


请 参阅 
C# 参考 
Visual C# 


C 编程 指南 
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在 C# 程序 内 部 


本 节 讨 论 CH 程序 的 一 般 结 构 ， 还 包括 标准 的 “Hello, World!’ HI, 


本 节 内 容 


e Hello World -- 您 的 第 一 个 程序 (CH 编程 指南 ) 
e CH 程序 的 通用 结构 (CH 编程 指南 ) 


相关 章节 


e Visual C£ Aj] 
e CH 编程 指南 
e CH EBS 


e <paveover>C# Sample Applications 


\ 工 = < 
CH 语言 规 ; 


有 关 详 细 信 息 ， 请 参阅 CH is SAIC. 规范 是 C# 语法 和 用 法 的 权威 资料 。 


cat 
M 
N 
s 
ili 


请 参阅 


C# 编程 指南 


Hello World -- 您 的 第 一 个 程序 (CH 编程 指南 ) 


以 下 过 程 创建 C# 版 本 的 传统 “Hello World!" 程 序 。 该 程序 显示 字符 串 Hello World! 
有 关 入 门 概念 的 更 多 示例 ， 请 参见 Visual C£ 和 Visual Basic Ai]. 
8 注意 


以 下 说 明 中 的 某 些 Visual Studio 用 户 界 面 元 素 在 计算 机 上 出 现 的 名 称 或 位 置 可 
能 会 不 同 。 这 些 元 素 取决 于 你 所 使 用 的 Visual Studio 版 本 和 你 所 使 用 的 设置 
有 关 详 细 信 息 ， 请 参阅 个 性 化 Visual Studio IDE, 


创建 并 运行 控制 台 应 用 程序 


1. 启动 Visual Studio, 
2. 在 菜单 栏 上 ， 选 择 “ 文 件 ”，“ 新 建 、“ 项 目 ”。 
将 打开 “新 建 项 目 ” 对 话 框 。 
3. 展开 “已 安装 "”， 展 开 “ 模 板 ”， 展 开 “Visual C 坟 ， 然 后 选择 “控制 台 应 用 程序 ”。 
4. 在 “名 称 ” 框 中 ， 指 定 项 目 名称 ， 然 后 选中 “确定 ”按钮 。 
新 项 目 出 现在 “解决 方案 资源 管理 器 ”中 。 


5. 如 果 Program.cs 不 是 在 “代码 编辑 器 "中 打开 ， 则 打开 “解决 方案 资源 管理 
器 "中 “Program.cs” 的 快捷 方式 菜单 ， 然 后 选择 “视图 代码 ”。 


6. 用 下 面 的 代码 替换 Program.cs 的 内 容 。 
// A Hello World! program in C£. 


using System; 
namespace HelloWorld 


{ 
class Hello 
{ 
static void Main() 
{ 
Console.WriteLine("Hello World!"); 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 


7. 选择 Fb 键 运行 项 目 。 命 令 提 示 窗 口 将 显示 ， 其 中 包含 行 Hello World! 


接着 ， 检 查 本 程序 的 重要 部 分 。 
注释 
第 一 行 包含 注释 。// 字符 将 这 行 的 其 余 内 容 转换 为 注释 内 容 。 


// A Hello World! program in C£. 


it np REXOCAGAIBOT / 和 /字符 之 间 将 其 注释 掉 。 这 将 在 下 面 的 示例 中 显示 。 


/* A "Hello World!" program in C£. 
This program displays the string "Hello World!" on the screen. */ 


BM xj 


Main 方法 
CH 控制 台 应 用 程序 必须 包含 一 个 Main 方法 ， 用 于 控制 程序 的 开始 和 结束 。 在 
Main 方法 中 创建 对 象 和 执行 其 他 方法 。 


Main 方法 是 驻 留 在 类 或 结构 内 的 static (CZ 2) 方法 。 在 前 面 的 “Hello 
World 示例 中 ， 此 方法 驻 留 在 一 个 名 为 Hello 的 类 中 。 可 以 用 下 列 方式 之 一 声明 
Main 方法 : 


e. 该 方式 返回 void, 


static void Main() 


{ 
} 


AR 


e 它 还 可 以 返回 整数 。 


static int Main() 


t 
JU EU 


return 0; 


e 无 论 使 用 哪 种 返回 类 型 ， 它 都 可 以 带 有 参数 。 


static void Main(string[] args) 


AL 


static int Main(string[] args) 


TOP UE 
return 0; 


Main 方法 中 定义 的 参数 args 是 一 个 string (字符 串 ) 类 型 的 数组 ， 该 数组 的 内 容 为 
在 命令 行 下 调用 本 程序 时 提供 的 参数 。 与 C++ 不 同 ， 数 组 不 包含 可 执行 (exe) 文 
件 的 文件 名 。 


有 关 如 何 使 用 命令 行 参数 的 更 多 信息 ， 请 参见 Main() 和 命令 行 参数 (CH 编程 指 
Fg) 中 的 示例 和 如 何 : 使 用 命令 行 创 建 和 使 用 程序 集 (CH 和 Visual Basic) 。 


通过 按 F5 在 调试 模式 下 运行 程序 时 ， 在 Main 方法 的 末尾 调用 ReadKey 将 使 得 控 
制 台 窗口 无 法 关闭 ， 从 而 使 您 可 以 阅读 输出 。 


输入 和 输出 

CH 程序 通常 使 用 NET Framework 的 运行 库 提供 的 输入 /输出 服务 。 
System.Console.WriteLine("Hello World!"); 语句 使 用 WriteLine 方法 。 此 方法 是 运 
行 库 中 的 Console 类 的 输出 方法 之 一 。 它 显示 了 标准 输出 流 使 用 的 字符 串 参 数 ， 输 
出 流 后 面 跟 一 个 新 行 。 其 他 Console 方法 用 于 不 同 的 输入 和 输出 操作 。 如 果 程 序 开 
33^. 814 using System; 指令 ， 则 无 需 完全 限定 System 类 和 方法 即 可 直接 使 用 它 
们 。 例 如 ， 您 可 以 改 为 调用 Console.WriteLine 而 非 System.Console.WriteLine : 


using System; 
Console.WriteLine("Hello World!"); 
有 关 输 入 /输出 方法 的 更 多 信息 ， 请 参见 System.1O。 


命令 行 编译 和 执行 


可 以 使 用 命令 行 而 不 是 Visual Studio 集成 开发 环境 (IDE) 编译 “Hello World!" 程序 。 


人 命令 提示 行 编译 并 运 


1. 将 前 面 过 程 的 代码 粘贴 到 任何 文本 编辑 器 中 ， 并 将 文件 保存 为 文本 文件 。 文 件 
Hello.cs 的 名 称 。C# 源 代码 文件 使 用 的 扩展 名 是 .cs。 


2. 执行 以 下 步骤 之 一 打开 命令 提示 符 窗 口 : 


o 在 Windows 8 中 ， 在 “开始 "屏幕 ， 搜 索 开 发 人 员 命 令 提 示 ， 然 后 点 击 或 选 
1£"VS2012 开发 人 员 命 命 提示 ”。 


将 出 现 "开发 人 员 命 令 提 示 符 " 窗 口 。 


o 在 Windows 7 中 ， 打 开 “ 开 始 " 菜 单 ， 展 开 当 前 Visual Studio 版 本 的 文件 
夹 ， 打 开 “Visual Studio 工具 ”的 快捷 菜单 ， 然 后 选择 “VS2012 开发 人 员 命 
兮 提示 ” 


将 出 现 "开发 人 员 命令 提示 符 "窗口 。 
。 从 标准 “ 命 全 提示 "窗口 启用 命 全 行 生成 。 


请 参见 How to: Set Environment Variables forthe Visual Studio 
Command Line。 


3. 在 命令 提示 窗口 中 ， 导 航 至 包含 Hello.cs 文件 的 文件 夹 。 
4. 输入 下 面 的 命令， 编译 Hello.cs。 
csc Hello.cs 
如 果 您 的 程序 中 有 没有 编译 错误 ， 则 将 创建 名 为 Hello.exe 的 可 执行 文件 。 
.命令 提示 符 窗口 中 ， 输 入 以 下 命令 运行 程序 : 
Hello 
AK CH 编译 器 及 其 选项 的 详细 信息 ， 请 参阅 CH Compiler Options. 


重要 章节 


在 Visual C£ 2010 使 用 入 门 中 编写 CH 程序 


青 参 阅 

C# 编程 指南 

在 CH 程序 内 部 
FE (CH 编程 指南 ) 


<paveover>C# Sample Applications 


MSDN C# 编程 指南 & 参考 手册 2015 


CH BS 
Main() 和 命 爸 行 参数 (CH 编程 指南 ) 
Visual C# 和 Visual Basic 入 门 


Hello World -- 您 的 第 一 个 程序 (C# 编程 指南 ) 
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CH 程序 的 通用 结构 (CH 编程 指南 ) 


CH 程序 可 由 一 个 或 多 个 文件 组 成 。 每 个 文件 都 可 以 包含 震 个 或 需 个 以 上 的 命名 空 
间 。 一 个 命名 空间 除了 可 包含 其 他 命名 空间 外 ， 还 可 包含 类 、 结 构 、 接 口 、 枚 举 、 
委托 等 类 型 。 以 下 是 C# 程序 的 主干 ， 它 包含 所 有 这 些 元 素 。 


// A skeleton of a C# program 
using System; 
namespace YourNamespace 


{ 
class YourClass 
{ 
} 
struct YourStruct 
if 
} 
interface IYourInterface 
{ 
} 
delegate int YourDelegate(); 
enum YourEnum 
{ 
} 
namespace YourNestedNamespace 
{ 
struct YourStruct 
{ 
J 
} 
class YourMainClass 
{ 
static void Main(string[] args) 
//Your program starts here... 
} 
} 
} 


相关 章节 
有 关 更 多 信息 : 


MSDN C# 编程 指南 & 参考 手册 2015 


e X (CH 编程 指南 ) 

e 结构 (CH 编程 指南 ) 

e 命名 空间 (CH 编程 指南 ) 
e 接口 (C£ 编程 指南 ) 

e 委托 (CH 编程 指南 ) 


CH 话 言 规 泄 


有 关 详 细 信息 ， 请 参阅 C# 语言 规范 。i 


请 参阅 

C# 编程 指南 
在 Cit 程序 内 部 
C# 参考 


<paveover>C# Sample Applications 


CH 程序 的 通用 结构 (CHE 编程 指南 ) 


规范 是 C# 语法 和 用 法 的 权威 资料 。 
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CH 编码 约定 (CH 编程 指南 ) 

CH 语言 规范 未 定义 编码 标准 。 但 是 ， Microsoft 根据 本 主题 中 的 准则 来 开发 样本 和 
文档 。 

编码 约定 可 实现 以 下 目的 : 

e 它们 为 代码 创建 一 致 的 外 观 ， 以 确保 读 取 器 专注 于 内 容 而 非 布局 。 

门 使 得 读 取 器 可 以 通过 基于 之 前 的 经 验 进 行 的 假设 更 快 地 理解 代码 。 

门 便 于 复制 、 更 改 和 维护 代码 。 

门 展示 CH 最 佳 做 法 。 





e 
Ot Ot Ot 


命名 约定 
。 在 不 包括 using 指令 的 短 示例 中 ， 使 用 命名 空间 限定 。 如 果 你 知道 命名 空间 加 


认 导 入 项 目 中 ， 则 不 必 完 全 限定 来 自 该 命名 空间 的 名 称 。 如 果 对 于 单行 来 说 过 
长 ， 则 可 以 在 点 (.) 后 中 断 限定 名 称 ， 如 下 面 的 示例 所 示 。 


var currentPerformanceCounterCategory = new System.Diagnostics. 
PerformanceCounterCategory(); 


LEN Lu 


e. 你 不 必 更 改 通过 使 用 Visual Studio 设计 器 工具 创建 的 对 象 的 名 称 以 使 它们 适合 
其 他 准则 。 


布局 约定 
好 的 布局 利用 格式 设置 来 强调 代码 的 结构 并 使 代码 更 便于 阅读 。Microsoft zx BUR 
本 符合 以 下 约定 : 


e 使 用 默认 的 代码 编辑 器 设置 (智能 缩 进 、4 字符 缩 进 、 制 表 符 保存 为 空格 ) 。 
有 关 详 细 信 息 ， 请 参阅 选项 、 文 本 编辑 器 、C#、 格 式 设 置 。 


如 果 连 续 行 未 自动 缩 进 ， 请 将 它们 缩 进 一 个 制 表 符 位 (四 个 空格 ) 。 
e. 在 方法 定义 与 属性 定义 之 间 添 加 至 少 一 个 空白 行 。 
使 用 括号 突出 表达 式 中 的 子 句 ， 如 下 面 的 代码 所 示 。 


if ((vali &gt; val2) && (vali &gt; val3)) 


// Take appropriate action. 


注释 约定 

。 将 注释 放 在 单独 的 行 上 ， 而 非 代码 行 的 末尾 。 

。 以 大 写字 母 开始 注释 文本 。 

。 以 句点 结束 注释 文本 。 

。 在 注释 分 隔 符 (//) 与 注释 文本 之 间 插 入 一 个 空格 ， 如 下 面 的 示例 所 示 。 


// The following declaration creates a query. It does not run 
// the query. 


B m——— ——————————————— fi 


e 不 要 在 注释 周围 创建 格式 化 的 星 号 块 。 


语言 准则 


以 下 各 节 介 绍 C# 遵循 以 准备 代码 示例 和 样本 的 做 法 。 


String 数据 类 型 
e 使 用 + 运算 符 来 连接 短 字 符 串 ， 如 下 面 的 代码 所 示 。 


string displayName = nameList[n].LastName + ", " + nameList[n]. 


。 若 要 在 循环 中 追加 字符 串 ， 尤 其 是 在 使 用 大 量 文本 时 ， 请 使 用 StringBuilder 对 


o 





var phrase - "lalalalalalalalalalalalalalalalalalalalalalalalal 
var manyPhrases - new StringBuilder(); 
for (var i = 0; i &lt; 10000; i++) 


{ 
} 


//Console.WriteLine("tra" + manyPhrases); 


4 Ern 


manyPhrases.Append(phrase); 








隐 陈 类 型 的 局 部 变量 


e 当 变 量 类 型 明显 来 自 赋值 的 右 侧 时 ， 或 者 当 精 度 类 型 不 重要 时 ， 请 对 本 地 变量 
进行 隐 式 类 型 化 。 





// When the type of a variable is clear from the context, use v 


// in the declaration. 


var vari - "This is clearly a string."; 
var var2 = 27; 
var var3 - Convert.ToInt32(Console.ReadLine()); 


‘| 





e 当 类 型 并 非 明 显 来 自 赋 值 的 右 侧 时 ， 请 勿 使 用 var。 


// When the type of a variable is not clear from the context, 
// explicit type. 
int var4 = ExampleClass.ResultSoFar(); 





e 请 勿 依靠 变量 名 称 来 指定 变量 的 类 型 。 它 可 能 不 正确 。 


// Naming the following variable inputInt is misleading. 
// It is a string. 

var inputInt = Console.ReadLine(); 
Console.WriteLine(inputInt); 


e. 避免 使 用 var 来 代替 dynamic, 
e 使 用 隐 式 类 型 化 来 确定 for 和 foreach 循环 中 循环 变量 的 类 型 。 
下 面 的 示例 在 for 语句 中 使 用 隐 式 类 型 化 。 


var syllable = "ha"; 
var laugh = ""; 
for (var i = 0; i &lt; 10; i++) 


laugh += syllable; 
Console.WriteLine(laugh); 


下 面 的 示例 在 foreach 语句 中 使 用 隐 式 类 型 化 。 





L 


foreach (var ch in laugh) 


if (ch == 'h') 
Console.Write("H"); 
else 
Console.Write(ch); 


} 


Console.WriteLine(); 


无 符号 数据 类 型 
。 通常， 使 用 int 而 非 无 符号 类 型 。 int 的 使 用 在 整个 C# 中 都 很 常见 ， 并 且 当 你 
使 用 int 时 ， 更 易于 与 其 他 库 交 互 。 
数组 
e 当 在 声明 行 上 初始 化 数组 时 ， 请 使 用 简洁 的 语法 。 


// Preferred syntax. Note that you cannot use var here instead 


string[] vowelsi = ( "a", "e", "i", "o", "uy" Y; 


// If you use explicit instantiation, you can use var. 


var vowels2 = new string[] ( "a", "e", "i", "o", "uy" }; 


// If you specify an array size, you must initialize the elemer 
var vowels3 = new string[5]; 

vowels3[0] = "a"; 

vowels3[1] = "e"; 

// And so on. 





Bit 
e 使 用 简洁 的 语法 来 创建 委托 类 型 的 实例 。 


// First, in class Program, define the delegate type and a me 
// has a matching signature. 


// Define the type. 
public delegate void Del(string message); 


// Define a method that has a matching signature. 
public static void DelMethod(string str) 


t 
Console.WriteLine("DelMethod argument: {0}", str); 


[a eR TR 





// In the Main method, create an instance of Del. 


// Preferred: Create an instance of Del by using condensed synt 
Del exampleDel2 - DelMethod; 


// The following declaration uses the full syntax. 
Del exampleDel1 = new Del(DelMethod); 


n] ——————G——————c— n 





异常 处 理 中 的 try-catch 和 using 语句 


e 对 大 多 数 异 常 处 理 使 用 try-catch 语句。 


static string GetValueFromArray(string[] array, int index) 


{ 
try 
{ 
return array[index]; 
catch (System.IndexOutOfRangeException ex) 
{ 
Console.WriteLine("Index is out of range: {0}", index); 
throw; 
} 
} 





e 通过 使 用 CÓ using 语句 简化 你 的 代码 。 如 果 你 具有 try-finally 语句 (该 语句 中 
finally 块 的 唯一 代码 是 对 Dispose 方法 的 调用 ) ， 请 使 用 using ORB, 


// This try-finally statement only calls Dispose in the finally 
Font fonti - new Font("Arial", 10.0f); 
try 


byte charset = fonti.GdiCharSet; 


} 
finally 


if (font1 != null) 


{ 
((IDisposable)font1).Dispose(); 


} 


// You can do the same thing with a using statement. 
using (Font font2 = new Font("Arial", 10.0f)) 


( 


byte charset - font2.GdiCharSet; 





&& 和 || 运算 符 


。 知 要 通过 跳 过 必要 的 比较 来 避免 异常 和 提高 性 能 ， 请 在 执行 比较 时 使 用 && 来 
RE &， 使 用 || 来 代替 | ， 如 下 面 的 示例 所 示 。 


下 


Console.Write("Enter a dividend: "); 
var dividend - Convert.ToInt32(Console.ReadLine()); 


Console.Write("Enter a divisor: "); 
var divisor - Convert.ToInt32(Console.ReadLine()); 


// If the divisor is ©, the second clause in the following conc 
// causes a run-time error. The && operator short circuits wher 
// first expression is false. That is, it does not evaluate the 
// second expression. The & operator evaluates both, and causes 
// a run-time error when divisor is 0. 

if ((divisor != 0) && (dividend / divisor &gt; 0)) 

1 

} 

else 


t 
j 


Console.WriteLine("Quotient: {0}", dividend / divisor); 


Console.WriteLine("Attempted division by 0 ends up here."); 











New 


运算 符 


e 隐 式 类 型 化 时 ， 请 使 用 对 象 实例 化 的 简洁 形式 ， 如 下 面 的 声明 所 示 。 


var instance1 = new ExampleClass(); 


上 一 行 等 同 于 下 面 的 声明 。 


ExampleClass instance2 = new ExampleClass(); 


e 使 用 对 象 初始 值 设 定 项 来 简化 对 象 创建 。 


// Object initializer. 
var instance3 = new ExampleClass { Name = "Desktop", ID = 37414 
Location = "Redmond", Age = 2.3 Y; 


// Default constructor and assignment statements. 
var instance4 - new ExampleClass(); 
instance4.Name - "Desktop"; 

instance4.ID = 37414; 

instance4.Location = "Redmond"; 

instance4.Age = 2.3; 





事件 处 理 
。 如果 你 正定 义 一 个 稍 后 不 需要 删除 的 事件 处 理 程序 ， 请 使 用 lambda 表达 式 。 


public Form2() 
{ 


// You can use a lambda expression to define an event hand] 
this.Click += (s, e) =&gt; 
{ 


MessageBox. Show( 
((MouseEventArgs)e).Location.ToString()); 





// Using a lambda expression shortens the following traditior 
public Form1() 


this.Click += new EventHandler(Formi Click); 


} 
void Formi Click(object sender, EventArgs e) 
: MessageBox. Show( ( (MouseEventArgs)e).Location.ToString()); 
} 
‘| — 








静态 成 员 


e 通过 使 用 类 名 称 调用 静态 成 员 : ClassName.StaticMember。 这 种 做 法 通过 明 
确 静 态 访 问 使 代码 更 易于 阅读 。 请 勿 使 用 派生 类 的 名 称 限 定 基 类 中 定义 的 静态 
成 员 。 编 译 该 代码 时 ， 代 码 可 读 性 具有 误导 性 ， 如 果 向 派生 类 添加 具有 相同 名 
称 的 静态 成 员 ， 代 码 可 能 会 被 破坏 。 


LINQ 查询 
。 对 查询 变量 使 用 有 意义 的 名 称 。 下 面 的 示例 为 位 于 西雅图 的 客户 使 用 
seattleCustomers。 


var seattleCustomers = from cust in customers 
where cust.City -- "Seattle" 
select cust.Name; 


e 使 用 别名 确保 匿名 类 型 的 属性 名 称 都 使 用 Pascal 大 小 写 格 式 正确 大 写 。 


var localDistributors = 
from customer in customers 
Join distributor in distributors on customer.City equals di 
select new { Customer = customer, Distributor = distributor 


pje 


e 如 果 结 果 中 的 属性 名 称 模 棱 两 可 ， 请 对 属性 重 命名 。 例 如 ， 如 果 你 的 查询 返回 
客户 名 称 和 分 销 商 ID， 而 不 是 在 结果 中 将 它们 保留 为 Name 和 ID， 请 对 它们 
进行 重 命名 以 明确 Name 是 客户 的 名 称 ，ID 是 分 销 商 的 ID。 





var localDistributors2 - 
from cust in customers 
join dist in distributors on cust.City equals dist.City 
select new ( CustomerName - cust.Name, DistributorID - dist 








‘| 





e 在 查询 变量 和 范围 变量 的 声明 中 使 用 隐 式 类 型 化 。 


var seattleCustomers = from cust in customers 
where cust.City == "Seattle" 
select cust.Name; 


e 对 齐 from 子 句 下 的 查询 子 句 ， 如 上 面 的 示例 所 示 。 


e 在 其 他 查询 子 句 之 前 使 用 where 子 句 ， 以 确保 后 面 的 查询 子 句 作 用 于 经 过 减少 
和 筛选 的 数据 集 。 


var seattleCustomers2 = from cust in customers 
where cust.City == "Seattle" 
orderby cust.Name 
select cust; 


e 使 用 多 行 from FANS join 子 句 以 访问 内 部 集合 。 例 如 ，Student 对 象 的 集 
合 可 能 包含 测验 分 数 的 集合 。 当 执行 以 下 查询 时 ， 它 返回 高 于 90 的 分 数 ， 并 
返回 得 到 该 分 数 的 学 生 的 姓氏 。 


// Use a compound from to access the inner sequence within eact 
var scoreQuery - from student in students 

from score in student.Scores 

where score &gt; 90 

select new ( Last = student.LastName, score }; 





安全 性 
请 遵循 代码 安全 维护 指南 中 的 准则 。 
请 参阅 


Visual Basic 编码 约定 


代码 安全 维护 指南 


数组 (CH 编程 指南 ) 


可 以 在 一 个 数组 数据 结构 中 存储 同一 类 型 的 多 个 变量 。 通 过 指定 其 元 素 的 类 型 声明 


数组 。 


type[] arrayName; 


下 面 的 示例 创建 一 维 、 多 维和 交错 数组 : 


class TestArraysClass 


( 


static void Main() 


( 


// Declare a single-dimensional array 
int[] array1 = new int[5]; 


// Declare and set array element values 
int[] array2 = new int[] (1, 3, 5, 7, 9 }; 


// Alternative syntax 
int[] arrays = { 2, 3, 4,5,6}; 


// Declare a two dimensional array 
int[,] multiDimensionalArrayi = new int[2, 3]; 


// Declare and set array element values 
int[,] multiDimensionalArray2 = ( { 1, 2, 3 }, (4,5, 6 3 


// Declare a jagged array 
int[][] jaggedArray - new int[6][]; 


// Set the values of the first array in the jagged array si 
jaggedArray[0] = new int[4] ( 1, 2, 3, 4 }; 





数组 概述 


数组 具有 以 下 属性 : 
e 数组 可 以 是 一 维 、 多 维 或 交错 的 。 


e 当 创 建 了 数组 实例 时 ， 将 建立 维度 数 和 每 个 维度 的 长 度 。 在 实例 的 生存 期 内 ， 
这 些 值 不 能 更 改 。 


e 数值 数组 元 素 的 默认 值 设置 为 需 ， 而 引用 元 素 的 默认 值 设置 为 null。 


交错 数组 是 数组 的 数组 ， 因 此 其 元 素 是 引用 类 型 并 初始 化 为 null。 
数组 的 索引 从 堆 开 始 : 具有 n 个 元 素 的 数组 的 索引 是 从 0 到 n-1。 
数组 元 素 可 以 是 任何 类 型 ， 包 括 数组 类 型 。 

数组 类 型 是 从 抽象 基 类 型 Array 派生 的 引用 类 型 。 由 于 此 类 型 实现 了 


IEnumerable 和 IEnumerable<T>， 因 此 可 以 对 CH 中 的 所 有 数组 使 用 foreach 
EK. 


相关 章节 


e 作为 对 象 的 数组 (CH 编程 指南 ) 

e 对 数组 使 用 foreach (CH 编程 指南 ) 

e 将 数组 作为 参数 传递 (CH 编程 指南 ) 

e 使 用 ref 和 out 传递 数组 (CH 编程 指南 ) 


e More About Variables 《有关 变量 的 更 多 信息 ) 位 于 Beginning Visual CZ 
2010 (开始 Visual C# 2010) 中 


vs = um 
C# ;£mBISUO 
有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 


C 编程 指南 
集合 (C# 和 Visual Basic) 
Array Collection Type 


作为 对 象 的 数组 (CH 编程 指 两 ) 


在 C# 中 ， 数 组 实际 上 是 对 象 ， 而 不 只 是 像 C 和 C++ 中 那样 的 可 寻 址 连续 内 存 区 
域 。 Array 是 所 有 数组 类 型 的 抽象 基 类 型 。 可 以 使 用 Array 具有 的 属性 以 及 其 他 类 
成 员 。 这 种 用 法 的 一 个 示例 是 使 用 Length 属性 来 获取 数组 的 长 度 。 下 面 的 代码 将 
numbers 数组 的 长 度 (为 5) 赋 给 名 为 lengthOfNumbers 的 变量 : 


int[] numbers = (1, 2, 3, 4, 5 Y 
int lengthOfNumbers = numbers.Length; 


Array 类 提供 了 许多 其 他 有 用 的 方法 和 属性 ， 用 于 排序 、 搜 索 和 复制 数组 。 


示例 


此 示例 使 用 Rank 属性 来 显示 数组 的 维 数 。 


class TestArraysClass 
static void Main() 
// Declare and initialize an array: 


int[,] theArray - new int[5, 10]; 
System.Console.WriteLine("The array has (0) dimensions.", 1 


// Output: The array has 2 dimensions. 





ZUR (CH 编程 指南 ) 一 维 数组 (CH 编程 指南 ) 多 维 数组 (CH 编程 指南 ) 交错 
数组 (CH 编程 指南 ) 


C 编程 指南 


一 维 数组 (CH 编程 指南 ) 
可 按 下 面 的 示例 所 示 声 明 五 个 整数 的 一 维 数组 。 


int[] array = new int[5]; 


此 数组 包含 从 array[0] 到 array[4] 的 元 素 。 new 运算 符 用 于 创建 数组 并 将 数组 元 素 
初始 化 为 它们 的 默认 值 。 在 此 例 中 ， 所 有 数组 元 素 都 初始 化 为 震 。 


可 以 用 相同 的 方式 声明 存储 字符 串 元 素 的 数组 。 例 如 : 


string[] stringArray = new string[6]; 


25 28 2815 


可 以 在 声明 数组 时 将 其 初始 化 ， 在 这 种 情况 下 不 需要 级 别 说 明 符 ， 因 为 级 别 说 明 符 
已 经 由 初始 化 列表 中 的 元 素数 提供 。 例 如 : 


int[] arrayi = new int[] (1, 3, 5, 7, 9 }; 


可 以 用 相同 的 方式 初始 化 字符 串 数组 。 下 面 声明 一 个 字符 串 数 组 ， 其 中 每 个 数组 元 
素 用 每 天 的 名 称 初始 化 : 


string[] weekDays - ( "Sun", "Mon", "Tue", "wed", "Thu", "Fri", "S: 
如 果 在 声明 数组 时 将 其 初始 化 ， 则 可 以 使 用 下 列 快捷 方式 : 





int[] array2 = { 1, 3, 5, 7, 9 }; 
String[] weekDays2 = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "$ 


|i EEE) 


可 以 声明 一 个 数组 变量 但 不 将 其 初始 化 ， 但 在 将 数组 分 配给 此 变量 时 必须 使 用 new 
运算 符 。 例 如 : 





int[] array3 
array3 = new int[] (1, 3, 5, 7, 9 5 // OK 
//array3 = (1, 3, 5, 7, 9}; // Error 


C£ 3.0 引入 了 隐 式 类 型 的 数组 。 有 关 更 多 信息 ， 请 参见 隐 式 类 型 的 数组 (CH 编程 
指南 ) 。 


值 类 型 数组 和 引用 类 型 数组 
请 看 下 列 数组 声明 : 


SomeType[] array4 = new SomeType[10]; 


该 语句 的 结果 取决 于 SomeType 是 值 类 型 还 是 引用 类 型 。 如 果 为 值 类 型 ， 则 语句 将 
创建 一 个 有 10 个 元 素 的 数组 ， 每 个 元 素 都 有 SomeType 类 型 。 如 果 SomeType 是 
引用 类 型 ， 则 该 语句 将 创建 一 个 由 10 个 元 素 组 成 的 数组 ， 其 中 每 个 元 素 都 初始 化 
为 空 引用 。 


有 关 值 类 型 和 引用 类 型 的 更 多 信息 ， 请 参见 类 型 〈C# 参考 ) 。 
请 参阅 
Array 
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多 维 数组 (CH 编程 指南 ) 
数组 可 以 具有 多 个 维度 。 例 如 ， 下 列 声明 创建 一 个 四 行 两 列 的 二 维 数组 。 


int[,] array = new int[4, 2]; 


下 列 声明 创建 一 个 三 维 (4、2 和 3) 数组 。 


int[, ,] array1 = new int[4, 2, 3]; 


B28 «nato 


可 以 在 声明 数组 时 将 其 初始 化 ， 如 下 例 所 示 。 


// Two-dimensional array. 

inti, | array2D = new int[,] 1 {1,2 }, 4 3, 4 b {15,6}, 1 7, 8 

// The same array with dimensions specified. 

int, ] array2Da = new int[4, 2] { { 1, 2 ^, { 3, 4 }, 15, 6 M fo 

// A similar array with string elements. 

string[,] array2Db = new string[3, 2] ( { "one", "two" }, { "three' 
{ "five", "cix" } I» 


// Three-dimensional array. 
int[, ,] array3D = new int[,,] (((1, 2, 3 }, (4, 5, 6 J }, 
{ {7, 8, 9}, {10, 11, 12}}}, 
// The same array with dimensions specified. 
int[, ,] array3Da = new int[2, 2, 3] { ( { 1, 2, 3 
{ { 7, 8, 9 


// Accessing array elements. 
System.Console.WriteLine(array2D[0, 0]); 
System.Console.WriteLine(array2D[0, 1]); 
System.Console.WriteLine(array2D[1, 0]); 
System.Console.WriteLine(array2D[1, 1]); 
System.Console.WriteLine(array2D[3, 0]); 
System.Console.WriteLine(array2Db[1, 0]); 
System.Console.WriteLine(array3Da[1, ©, 1]); 
System.Console.WriteLine(array3D[1, 1, 2]); 


// Getting the total count of elements or the length of a given dir 
var allLength - array3D.Length; 
var total - 1; 
for (int i = 0; i < array3D.Rank; i++) ( 
total *- array3D.GetLength(1i); 
} 
System.Console.WriteLine("{0} equals {1}", allLength, total); 


// Output: 


// 12 equals 12 
Bes 
也 可 以 初始 化 数组 但 不 指定 级 别 。 





int[,] array4 = (01, 2}, (3, 4}, 05, 6}, { 7, 8) }; 


如 果 选 择 声 明 一 个 数组 变量 但 不 将 其 初始 化 ， 必 须 使 用 new 运算 符 将 一 个 数组 分 
配给 此 变量 。 以 下 示例 显示 new 的 用 法 。 


int[,] array5 
array5 - new int[,] { { 1, 2 Je { 3, 4 Y; T Sr 6 Is Un 8 } qu 4 
//arrayb = ((1,2), {3,4}, {5,6}, (7,8); // Error 


< m B 








以 下 示例 将 值 分 配给 特定 的 数组 元 素 。 
array5[2, 1] = 25; 

同样 ， 下 面 的 示例 获取 特定 数组 元 素 的 值 ， 并 将 它 赋 给 变量 elementValue。 
int elementValue = array5[2, 1]; 


以 下 代码 示例 将 数组 元 素 初 始 化 为 默认 值 (交错 数组 除外 ) 


int[,] array6 = new int[10, 10]; 


请 参阅 
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交错 数组 (CH 编程 指南 ) 

交错 数组 是 元 素 为 数组 的 数组 。 交 错 数 组 元 素 的 维度 和 大 小 可 以 不 同 。 交 错 数 组 有 
时 称 为 “数组 的 数组 ”以 下 示例 说 明 如 何 声明 、 初 始 化 和 访问 交错 数组 。 

下 面 声明 一 个 由 三 个 元 素 组 成 的 一 维 数组 ， 其 中 每 个 元 素 都 是 一 个 一 维 整数 数组 : 


int[][] jaggedArray = new int[3][]; 


必须 初始 化 jaggedArray 的 元 素 后 才 可 以 使 用 它 。 可 以 如 下 例 所 示 初 始 化 该 元 素 : 


jaggedArray[0] = new int[5]; 
jaggedArray[1] = new int[4]; 
jaggedArray[2] = new int[2]; 


du ou a 个 元 素 是 由 5 个 整数 组 成 的 数组 ， 第 二 个 是 
4 个 整数 组 成 的 数组 ， 而 第 三 个 是 由 2 个 整数 组 成 的 数组 。 


也 可 以 使 用 初始 值 设 定 项 用 值 填 充 数组 元 素 ， 在 这 种 情况 下 不 需要 数组 大 小 。 例 
如 : 


jaggedArray[0] = new int[] (1, 3, 5, 7, 9 }; 
jaggedArray[1] = new int[] (0, 2, 4, 6 Y; 
jaggedArray[2] = new int[] { 11, 22 Y; 


还 可 以 在 声明 数组 时 将 其 初始 化 ， 如 : 


int[][] jaggedArray2 = new int[][] 


{ 
new int[] {1,3,5,7,9}, 
new int[] {0,2,4, 6}, 
new int[] {11,22} 

3 


可 以 使 用 下 面 的 速记 格式 。 请 注意 : 不 能 从 元 素 初始 化 中 省 略 new 运算 符 ， 因 为 
不 存在 元 素 的 默认 初始 化 : 


int[][] jaggedArray3 = 


{ 
new int[] {1,3,5,7,9}, 
new int[] {0,2,4, 6}, 
new int[] {11,22} 

3 


交错 数组 是 数组 的 数组 ， 因 此 其 元 素 是 引用 类 型 并 初始 化 为 null。 
可 以 如 下 例 所 示 访 问 个 别 数组 元 素 : 


// Assign 77 to the second element ([1]) of the first array ([0]): 
jaggedArray3[0][1] = 77; 


// Assign 88 to the second element ([1]) of the third array ([2]): 
jaggedArray3[2][1] = 88; 


ES ES 


可 以 混合 使 用 交错 数组 和 多 维 数组 。 下 面 声明 和 初始 化 一 个 一 维 交 错 数组 ， 该 数组 
包含 大 小 不 同 的 三 个 二 维 数组 元 素 。 有 关 二 维 数组 的 详细 信息 ， 请 参阅 多 维 数组 
(CH 编程 指南 ) o 


int[][,] jaggedArray4 = new int[3][, ] 
{ 


new int[,] { {1,3}, (5,7) }, 
new int[,] { {0,2}, {4,6}, {8,10} }, 
new int[,] { {11,22}, {99,88}, {0,9} } 


Eo a a SUN 
5) : 


System.Console.Write("{0}", jaggedArray4[0][1, 0]); 


方法 Length 返回 包含 在 交错 数组 中 的 数组 的 数目 。 例 如 ， 假 定 您 已 声明 了 前 一 个 
数组 ， 则 此 行 : 


System.Console.WriteLine(jaggedArray4.Length); 


返回 值 3。 
本 例 生成 一 个 数组 ， 该 数组 的 元 素 为 数组 自身 。 每 一 个 数组 元 素 都 有 不 同 的 大 小 。 


class ArrayTest 


( 


static void Main() 


1 


} 
} 


// Declare the array of two elements: 
int[][] arr = new int[2][]; 


// Initialize the elements: 
arr[0] = new int[5] (1, 3, 5, 7, 9 }; 
arr[1] = new int[4] (2, 4, 6, 8 }; 


// Display the array elements: 
for (int i = 0; i < arr Length; i++) 
{ 
System.Console.Write("Element({0}): ", i); 


for (int j = 0; j < arr[i]-bength; j++) 
{ 


} 


System.Console.WriteLine(); 


System.Console.Write("{O}{1}", arr[i][j], j == (ar! 


j 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


/* Output: 
Element(0): 1 3 
Element(1): 2 4 


S mw m 
6 8 





Array 
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对 数组 使 用 foreach (C# 编程 指南 ) 


C# 还 提供 foreach 语句 。 该 语句 提供 一 种 简单 、 明 了 的 方法 来 循环 访问 数组 或 任 
AMARANTH. foreach 话 句 按 数组 或 集合 类 型 的 枚 举 器 返回 的 顺序 义理 元 
素 ， 该 顺序 通常 是 从 第 0 个 元 素 到 最 后 一 个 元 素 。 例如 ， 以 下 代码 创建 一 个 名 为 
numbers 的 数组 ， 并 使 用 foreach 语句 循环 访问 该 数组 : 


Int[] numbers = { 4, 5, 6, 1, 2, 3, -2, -1, O }; 
foreach (int i in numbers) 


System.Console.Write("{O} ", i); 


J 
// Output: 4 56 1 2 3 -2 -10 


借助 多 维 数组 ， 你 可 以 使 用 相同 的 方法 来 循环 访问 元 素 ， 例 如 : 


int[,] numbers2D = new int[3, 2] { { 9, 99 }, (3, 33 }, { 5, 55 } 

// Or use the short form: 

// inti, | numbers2D = { { 9, 99 }, { 3, 33}, { 5, 5} }; 

foreach (int i in numbers2D) 

System.Console.Write("{O} ", i); 

} 

// Output: 9 99 3 33 5 55 
E ans 5 
但 对 于 多 维 数组 ， 使 用 嵌 套 的 for 循环 可 以 更 好 地 控制 数组 元 素 。 





请 参见 


数组 (CH 编程 指南 ) 一 维 数组 (CH 编程 指南 ) 多 维 数 组 (CH 编程 指南 ) 交错 
数组 〈C# 编程 指南 ) Array 


C# 编程 指南 


将 数组 作为 参数 传递 (CH 编程 指南 ) 

数组 可 作为 实 参 传递 给 方法 形 参 。 由 于 数组 是 引用 类 型 ， 因 此 方法 可 以 更 改元 素 的 
值 。 

将 一 维 数 组 作为 参数 传递 

可 以 将 初始 化 的 一 维 数组 传递 给 方法 。 例 如 ， 下 面 的 洛 句 特 数组 发 送 到 print J 


Jo 
int[] theArray = { 1, 3, 5, 7, 9 Y; 
PrintArray(theArray); 

下 面 的 代码 显示 print 方法 的 部 分 实现 。 


void PrintArray(int[] arr) 


// Method code. 


您 可 以 在 一 个 步骤 中 初始 化 和 传递 新 数组 ， 如 下 面 的 示例 所 示 。 


PrintArray(new int[] { 1, 3, 5, 7, 9 3); 


示例 


说 明 

在 下 面 的 示例 中 ， 将 初始 化 一 个 字符 串 数 组 并 将 其 作为 参数 传递 到 字符 串 的 
PrintArray 方法 。 该 方法 显示 数组 的 元 素 。 接 下 来 ， 调 用 ChangeArray 和 
ChangeArrayElement 方法 以 演示 通过 值 发 送 数 组 参数 时 不 会 阻止 更 改 这 些 数 组 元 


代码 


class ArrayClass 


( 


static void PrintArray(string[] arr) 


( 


} 


for (int i = 0; i < arr.Length; i++) 


i 
} 


System.Console.WriteLine(); 


System.Console.Write(arr[i] + "(0)", i < arr.Length - : 


static void ChangeArray(string[] arr) 


( 


j 


// The following attempt to reverse the array does not per: 
// the method returns, because arr is a value parameter. 
arr = (arr.Reverse()).ToArray(); 

// The following statement displays Sat as the first elemer 
System.Console.WriteLine("arr[0] is {0} in ChangeArray.", 


static void ChangeArrayElements(string[] arr) 


( 


} 


// The following assignments change the value of individua: 
// elements. 


arr[0] = "Sat"; 
areas Sera 
arr[2] = "Thu"; 


// The following statement again displays Sat as the first 
// in the array arr, inside the called method. 
System.Console.WriteLine("arr[0] is {0} in ChangeArrayEleme 


static void Main() 


{ 


// Declare and initialize an array. 
string[] weekDays = { "Sun", "Mon", "Tue", "Wed", "Thu", "I 


// Pass the array as an argument to PrintArray. 
PrintArray(weekDays); 


// ChangeArray tries to change the array by assigning some 
// to the array in the method. 
ChangeArray(weekbDays); 


// Print the array again, to verify that it has not been cl 
System.Console.WriteLine("Array weekDays after the call to 
PrintArray(weekDays); 

System.Console.WriteLine(); 


// ChangeArrayElements assigns new values to individual ar! 
// elements. 
ChangeArrayElements(weekDays ) ; 


// The changes to individual elements persist after the met 
// Print the array, to verify that it has been changed. 
System.Console.WriteLine("Array weekDays after the call to 
PrintArray(weekDays) ; 


j 


77 Output: 

// Sun Mon Tue Wed Thu Fri Sat 

// arr[0] is Sat in ChangeArray. 

// Array weekDays after the call to ChangeArray: 
// Sun Mon Tue Wed Thu Fri Sat 


// arr[0] is Sat in ChangeArrayElements. 
// Array weekDays after the call to ChangeArrayElements: 
// Sat Fri Thu Wed Thu Fri Sat 


«| 党 








将 多 维 数组 作为 人 参数 传递 
可 采用 与 传递 一 维 数组 相同 的 方式 将 初始 化 的 多 维 数组 传递 给 方法 。 


int[,] theArray = { { 1, 2}, {12,33}, spon 4 Nds 
Print2DArray(theArray); 


下 面 的 代码 显示 print 方法 的 部 分 声明 ， 该 方法 接受 一 个 二 维 数组 作为 其 参数 。 


void Print2DArray(int[,] arr) 


// Method code. 


您 可 以 在 一 个 步骤 中 初始 化 和 传递 新 数组 ， 如 下 面 的 示例 所 示 。 


Print2DArray(new int[,] ( (1, 2), (3, 4), { 5, 6}, (7, 8 Y. 


说 明 


在 下 面 的 示例 中 ， 将 初始 化 一 个 二 维 整数 数组 并 将 其 传递 到 Print2DArray 方法 。 该 
方法 显示 数组 的 元 素 。 


代码 


class ArrayClass2D 


{ 
static void Print2DArray(int[,] arr) 
// Display the array elements. 
for (int i = 0; i < arr.GetLength(0); i++) 
for (int j = 0; j < arr.GetLength(1); j++) 
{ 
System.Console.WriteLine("Element( {0}, {1})={2}", i, 
} 
} 
static void Main() 
{ 
// Pass the array as an argument. 
Print2DArray(new int[,] 4 4 4, 2 | 4 3, 4 M { 5, 6 5 15 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
/* Output: 
Element (0, 0)=1 
Element (0, 1)=2 
Element(1,0)=3 
Element(1,1)=4 
Element (2,0)=5 
Element (2,1)=6 
Element (3,0)=7 
Element (3,1)=8 
=y 
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使 用 ref 和 out 传递 数组 (CHE 2S TE TRES) 


与 所 有 out 参数 一 样 ， 在 使 用 数组 类 型 的 out 参数 前 必须 先 为 其 赋值 ; 即 必须 由 被 
调用 方 为 其 赋值 。 例 如 : 


static void TestMethodi(out int[] arr) 


arr - new int[10]; // definite assignment of arr 


与 所 有 ref 参数 一 样 ， 数 组 类 型 的 ref 参数 必须 由 调用 方 明确 赋值 。 因 此 ， 不 需要 
由 被 调用 方 明确 赋值 。 可 以 将 数组 类 型 的 ref 参数 更 改 为 调用 的 结果 。 例 如 ， 可 以 
ARARA null 值 ， 或 将 其 初始 化 为 另 一 个 数组 。 例 如 : 

static void TestMethod2(ref int[] arr) 


arr = new int[10]; // arr initialized to a different array 


下 面 两 个 示例 演示 了 out ref 在 将 数组 传递 给 方法 时 的 用 法 差异 。 


在 此 示例 中 ， 在 调用 方 (Main 方法 ) 中 声明 数组 theArray， 并 在 FillArray 方法 中 
初始 化 此 数组 。 然 后 ， 数 组 元 素 将 返回 调用 方 并 显示 。 


class TestOut 


{ 


static void FillArray(out int[] arr) 


// Initialize the array: 
arr = new int[5] { 1, 2, 3,4,5}; 
} 


static void Main() 


( 


int[] theArray; // Initialization is not required 


// Pass the array to the callee using out: 
FillArray(out theArray); 


// Display the array elements: 
System.Console.WriteLine("Array elements are:"); 
for (int i = 0; i < theArray.Length; i++) 


{ 
} 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


System.Console.Write(theArray[i] + " "); 


j 


/* Output: 
Array elements are: 
12345 

n 


在 此 示例 中 ， 在 调用 方 (Main 方法 ) 中 初始 化 数组 theArray， 并 通过 使 用 ref 参数 
将 其 传递 给 FillArray 方法 。 在 FillArray 方法 中 更 新 某 些 数组 元 素 。 然 后 ， 数 组 元 
素 将 返回 调用 方 并 显示 。 


class TestRef 


( 


static void FillArray(ref int[] arr) 
{ 
// Create the array on demand: 
if (arr == null) 
{ 


arr = new int[10]; 


} 

// Fill the array: 
arr[0] uis bata te 
arr[4] 55557 


} 


static void Main() 
{ 
// Initialize the array: 
int[] theArray = { 1, 2, 3,4,5}; 


// Pass the array using ref: 
FillArray(ref theArray); 


// Display the updated array: 
System.Console.WriteLine("Array elements are:"); 
for (int i = 0; i < theArray.Length; i++) 


{ 
} 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


System.Console.Write(theArray[i] * " "); 


J 
/* Output: 
Array elements are: 


IE 235255355 
i4 
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使 用 ref 和 out 传递 数组 (C# 编程 指南 ) 


56 


隐 式 类 型 的 数组 (CH 编程 指南) 


可 以 创建 隐 式 类 型 的 数组 ， 在 这 样 的 数组 中 ， 数 组 实例 的 类 型 是 从 数组 初始 值 设 定 
项 中 指定 的 元 素 推 断 而 来 的 。 有 关 任 何 隐 式 类 型 变量 的 规则 也 适用 于 隐 式 类 型 的 数 
组 。 有 关 更 多 信息 ， 请 人 参见 隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) o 


在 查询 表达 式 中 ， 人 隐 式 类 型 的 数组 通常 与 匿名 类 型 以 及 对 象 初始 值 设 定 项 和 集合 初 
台 值 设 定 项 一 起 使 用 。 


下 面 的 示例 演示 如 何 创建 隐 式 类 型 的 数组 : 


class ImplicitlyTypedArraySample 


1 
static void Main() 
{ 
var a = new[] { 1, 10, 100, 1000 }; // int[] 
var b = new[] { "hello", null, "world" }; // string[] 
// single-dimension jagged array 
var c - new[] 
{ 
new[]{1, 2,3,4}, 
new[ ]{5,6,7,8} 
J; 
// jagged array of strings 
var d = new[] 
{ 
new[]{"Luca", "Mads", "Luke", "Dinesh"}, 
new[]("Karen", "Suma", "Frances"? 
J; 
} 
} 


请 注意 ， 在 上 一 个 示例 中 ， 没 有 在 初始 化 语句 的 左 侧 对 隐 式 类 型 的 数组 使 用 方 括 
号 。 另 请 注意 ， 交 错 数 组 就 像 一 维 数组 那样 使 用 new [] 进行 初始 化 。 


对 象 初始 值 设 定 项 中 的 隐 式 类 型 的 数组 


创建 包含 数组 的 匿名 类 型 时 ， 必 须 在 该 类 型 的 对 象 初始 值 设 定 项 中 对 数组 进行 隐 式 
类 型 化 。 在 下 面 的 示例 中 ，contacts 是 一 个 隐 式 类 型 的 匿名 类 型 数组 ， 其 中 每 个 匿 
名 类 型 都 包含 一 个 名 为 PhoneNumbers 的 数组 。 请 注意 ， 对 象 初始 值 设 定 项 内 部 
未 使 用 var 关键 字 。 
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var contacts - new[] 


{ 
new { 
Name = " Eugene Zabokritski", 
PhoneNumbers = new[] { "206-555-0108", 
tr 
new { 
Name = " Hanying Feng", 
PhoneNumbers = new[] { "650-555-0199" } 
} 
}; 


C# 编程 指南 

隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) 
数组 〈C# 编程 指南 ) 

匿名 类 型 (C# 编程 指南 ) 

对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) 
var (C£ 参考 ) 

LINQ 查询 表达 式 (CH 编程 指南 ) 


隐 式 类 型 的 数组 (CH 编程 指南 ) 


"425-555-0001" -` 
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类 和 结构 (CH 编程 指南 ) 


类 和 结构 是 .NET Framework 中 的 常规 类 型 系统 的 两 种 基本 构造 。 两 者 在 本 质 上 都 
属于 数据 结构 ， 封 装着 一 组 整体 作为 一 个 逻辑 单位 的 数据 和 行为 。 数 据 和 行为 是 该 
ee 它们 包含 各 自 的 方法 、 属 性 和 事件 等 (本 主题 后 面 列 出 了 这 些 
内 容 o 


类 或 结构 的 声明 类 似 于 蓝图 ， 用 于 在 运行 时 创建 实例 或 对 象 。 如 果 定 义 一 个 名 为 
Person 的 类 或 结构 ， 则 Person 为 类 型 名 称 。 如 果 声 明 并 初始 化 Person 类 型 的 变 
© p, N] p MH Person 的 对 象 或 实例 。 可 以 创建 同一 Person 类 型 的 多 个 实例 ， 每 
个 实例 在 其 属性 和 字段 中 具有 不 同 的 值 。 


类 是 一 种 "引用 类 型 "。 创 建 类 的 对 象 时 ， 对 象 赋值 到 的 变量 只 保存 对 该 内 存 的 引 
用 。 将 对 象 引 用 赋 给 新 变量 时 ， 新 变量 引用 的 是 原始 对 象 。 通 过 一 个 变量 做 出 的 更 
改 将 反映 在 另 一 个 变量 中 ， 因 为 两 者 引用 同一 数据 。 


结构 是 一 种 值 类 型 。 创 建 结构 时 ， 结 构 赋 值 到 的 变量 保存 该 结构 的 实际 数据 。 将 结 
构 赋 给 新 变量 时 ， 将 复制 该 结构 。 因 此 ， 新 变量 和 原始 变量 包含 同一 数据 的 两 个 不 
同 的 副本 。 对 一 个 副本 的 更 改 不 影响 另 一 个 副本 。 

类 通常 用 于 对 较为 复杂 的 行为 建 模 ， 或 对 要 在 创建 类 对 象 后 进行 修改 的 数据 建 模 。 
结构 最 适合 一 些小 型 数据 结构 ， 这 些 数据 结构 包含 的 数据 以 创建 结构 后 不 修改 的 数 
据 为 主 。 

有 关 更 多 信息 ， 请 参见 类 (C# 编程 指南 ) 、 对 象 (C# 编程 指南 ) 和 结构 (CH 编 
程 指南 ) 。 

下 面 的 示例 在 ProgrammingGuide 命名 空间 的 顶级 使 用 三 个 成 员 定 义 了 
MyCustomClass。 在 Program 类 的 Main 方法 中 创建 了 MyCustomClass 的 一 个 实 
例 (对 象 ) ， 并 使 用 点 表示 法 访问 该 对 象 的 方法 和 属性 。 


namespace ProgrammingGuide 


// Class definition. 
public class MyCustomClass 


( 


// Class members: 
// Property. 
public int Number ( get; set; j 


// Method. 
public int Multiply(int num) 


{ 
} 


// Instance Constructor. 
public MyCustomClass() 


{ 
} 


// Another class definition. This one contains 
// the Main method, the entry point for the program. 
class Program 


return num * Number; 


Number = 0; 


{ 
static void Main(string[] args) 
{ 
// Create an object of type MyCustomClass. 
MyCustomClass myClass = new MyCustomClass(); 
// Set the value of a public property. 
myClass.Number - 27; 
// Call a public method. 
int result - myClass.Multiply(4); 
} 
} 
} 
4 mm 
BTE 


“封装 "有 时 被 称 为 面向 对 象 的 编程 的 第 一 个 支柱 或 原则 。 根 据 封装 的 原则 ， 类 或 结 
构 可 以 指定 其 每 个 成 员 对 于 该 类 或 结构 外 部 的 代码 的 可 访问 性 。 可 将 无 意 在 类 或 程 
序 集 外 部 使 用 的 方法 和 变量 隐藏 起 来 ， 以 减 小 编码 错误 或 遭 恶 意 利 用 的 可 能 性 。 


有 关 类 的 更 多 信息 ， 请 参见 类 (CH 编程 指南 ) 和 对 象 (CH 编程 指南 ) o 


成 员 


所 有 方法 、 字 7 段 、 常 量 、 属 性 和 事件 都 必须 在 类 型 内 部 进行 声明 ; 这 些 称 为 类 型 

的 “成员 "。 与 其 他 一 些 语 言 不 同 的 是 ，C# 中 没有 全 局 变量 或 方法 。 即 使 是 作为 程序 
入 口 点 的 Main 方法 也 必须 在 类 或 结构 内 部 进行 声明 。 下 表 列 出 了 可 在 类 或 结构 中 
声明 的 所 有 不 同 种 类 的 成 员 。 


4} 
Xs 


Wo 


E ak 
HE 


e 方法 


e 运算 符 


e REZE 
辅助 功能 


有 些 方法 和 属性 要 供 类 或 结构 外 部 的 代码 ( 称 为 “客户 端 代码 ”) 调用 或 访问 。 另 有 
一 些 方法 和 属性 可 能 久 供 类 或 结构 在 自身 内 部 使 用 。 应 限制 您 的 代码 的 可 访问 性 ， 

只 多 许 应 当 访问 它们 的 客户 端 代 码 进行 访问 ， 这 一 点 十 分 重要 。 使 用 访问 修饰 符 

public、protected、internal、protected internal 和 private 可 以 指定 类 型 及 其 成 员 
对 于 客户 端 代码 的 可 访问 性 。 黑 认可 访问 性 为 private。 有 关 详 细 信 息 ， 请 参阅 访 
问 修 饰 符 (CH 编程 指南 ) 。 


Inheritance 


X (而 非 结 构 ) 文 持 继承 的 概念 。 派 生 自 另 一 个 类 (BR?) 的 类 将 自动 包含 基 类 
除 构造 本 数 和 析 构 函数 之 外 的 所 有 公共 、 受 保护 和 内 部 成 员 。 有 关 更 多 信息 ， 请 参 
见 继承 (CH 编程 指南 ) 和 多 态 性 (CH 编程 指南 ) o 

可 以 将 类 声明 为 抽象 类 ， 表 示 该 类 的 一 个 或 多 个 方法 不 具有 实现 。 抽 象 类 虽然 无 法 
直接 实例 化 ， 但 可 以 用 作 其 他 类 的 基 类 ， 由 其 他 类 提供 缺少 的 实现 。 还 可 以 将 类 声 
明 为 密封 类 ， 以 禁止 其 他 类 从 该 类 继承 。 有 关 详 细 信 息 ， 请 参阅 MRA, PALM 
AMA (CH 编程 指南 ) o 


接口 


类 和 结构 可 以 继承 多 个 接口 。 从 接口 继承 意味 着 该 类 型 要 实现 该 接口 中 定义 的 所 有 
方法 。 有 关 详 细 信 息 ， 请 参阅 接口 (CH 编程 指南 ) o 


泛 型 类 型 

可 以 使 用 一 个 或 多 个 类 型 参数 来 定义 类 和 结构 。 客 户 端 代码 在 创建 类 型 的 实例 时 提 
供 类 型 。 例 如 ，System.Collections.Generic 命名 空间 中 的 List<T> 类 使 用 一 个 类 

型 参数 进行 定义 。 客 户 端 代 码 创 建 List<string> 或 List<int> 的 实例 来 指定 列表 中 将 
包含 的 类 型 。 有 关 详 细 信 息 ， 请 参阅 泛 型 (CH 编程 指南 ) o 

静态 类 型 

可 以 将 类 (不 是 结构 ) 声明 为 静态 。 静 态 类 只 能 包含 静态 成 员 ， 不 能 使 用 new 关键 
字 进 行 实例 化 。 在 程序 加 载 时 ， 静 态 类 的 一 个 副本 将 加 载 到 内 存 中 ， 可 通过 类 名 称 
访问 该 类 的 成 员 。 类 和 结构 都 可 以 包含 静态 成 员 。 有 关 详 细 信息 ， 请 参阅 静态 类 和 
静态 类 成 员 (CH 编程 指南 ) 。 

BRE XS 
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分 部 类 型 


可 以 在 一 个 代码 文件 中 定义 类 、 结 构 或 方法 的 一 部 分 ， 而 在 另 一 个 代码 文件 中 定义 
另 一 部 分 。 有 关 更 多 信息 ， 请 参见 分 部 类 和 方法 。 


对 象 初始 值 设 定 项 


可 以 实例 化 和 初始 化 类 或 结构 对 象 以 及 对 象 的 集合 ， 无 需 显 式 调用 其 构造 本 数 。 有 
关 更 多 信息 ， 请 参见 对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) 。 


匿名 类 型 
在 不 方便 或 没 必要 创建 命名 类 的 情况 下 ， 例 如 当 使 用 无 需 保留 或 传递 给 其 他 方法 的 


数据 结构 填充 列表 时 ， 可 以 使 用 匿名 类 型 。 有 关 更 多 信息 ， 请 人 参见 匿名 类 型 (CH 
编程 指南 ) o 


扩展 方法 

通过 创建 一 个 单独 的 类 型 ， 然 后 将 该 类 型 的 方法 当 作 原 始 类 型 的 方法 来 调用 ， 可 以 
在 不 必 创建 派生 类 的 情况 下 对 类 进行 "扩展 "。 有 关 更 多 信息 ， 请 参见 扩展 方法 (CH 
编程 指南 ) 。 

隐 式 类 型 化 局 部 变量 


在 类 或 结构 方法 中 ， 可 以 使 用 隐 式 类 型 来 指示 编译 器 在 编译 时 确定 正确 的 类 型 。 有 
关 更 多 信息 ， 请 参见 隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) o 


CH 语言 规 


> 
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有 关 详 细 信 息 ， TB € 
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X (CH 编程 指南 ) 


“类 ?是 一 种 构造 ， 通 过 使 用 该 构造 ， 您 可 以 将 其 他 类 型 的 变量 、 方 法 和 事件 组 合 在 

一 起 ， 从 而 创建 自己 的 自 定 义 类 型 。 类 就 像 一 个 蓝图 ， 它 定义 类 型 的 数据 和 行为 。 

如 果 类 没有 声明 为 静态 类 ， 客 户 端 代 码 就 可 以 创建 赋 给 变量 的 “对 象 ” 或 “实例 5， 从 而 
使 用 该 类 。 在 对 变量 的 所 有 引用 都 超出 范围 之 前 ， 该 变量 始终 保持 在 内 存 中 。 所 有 
引用 都 超出 范围 时 ，CLR 将 标记 该 变量 以 供 垃圾 回收 。 如 果 类 声明 为 静态 类 ， 则 内 
存 中 只 存在 一 个 副本 ， 并 且 客 户 端 代码 只 能 通过 该 类 自身 而 不 是 实例 变量 "访问 该 

类 。 有 关 更 多 信息 ， 请 参见 静态 类 和 静态 类 成 员 (C# 编程 指南 ) o 


2 m 类 支持 “继承 "， 而 继承 是 面向 对 象 编 程 的 基础 特性 。 有 关 更 多 信息 
请 参见 继承 (Cu 编程 指南 ) 。 


声明 类 
类 使 用 class 关键 字 进 行 声 明 ， 如 下 面 的 示例 所 示 : 


public class Customer 


//Fields, properties, methods and events go here... 


class 关键 字 前 面 是 访问 级 别 。 由 于 在 该 例 中 使 用 public, 因此 任何 人 都 可 以 基于 
该 类 创建 对 象 。 类 的 名 称 位 于 class 关键 字 的 后 面 。 定 义 的 其 余部 分 是 类 的 主体 ， 
用 于 定义 行为 和 数据 . 类 的 字段 、 属 性 、 方 法 和 事件 统称 为 “类 成 员 ”。 
创建 对 象 


尽管 有 时 类 和 对 象 可 互 换 ， 但 它们 是 不 同 的 概念 。 类 定义 对 象 的 类 型 ， 但 它 不 是 对 
象 本 身 。 对 象 是 基于 类 的 具体 实体 ， 有 时 称 为 类 的 实例 。 


通过 使 用 new 关键 字 〈 后 跟 对 象 将 基于 的 类 的 名 称 ) 可 以 创建 对 象 ， 如 下 所 示 : 


Customer objecti = new Customer(); 


创建 类 的 实例 后 ， 将 向 程序 员 传 递 回 对 该 对 象 的 引用 。 在 前 面 的 示例 中 ，object1 
是 对 基于 Customer 的 对 象 的 引用 。 此 引用 引用 新 对 象 ， 但 不 包含 对 象 数据 本 身 。 
实际 上 ， 可 以 在 根本 不 创建 对 象 的 情况 下 创建 对 象 引 用 : 


Customer object2; 


建议 不 要 创建 像 这 样 的 不 引用 对 象 的 对 象 引 用 ， 因 为 在 运行 时 通过 这 样 的 引用 来 访 
问 对 象 的 尝试 将 会 失败 。 但 是 ， 可 以 创建 这 样 的 引用 来 引用 对 象 ， 方 法 是 创建 新 对 
象 ， 或 者 将 它 分 配给 现 有 的 对 象 ， 如 下 所 示 : 


Customer object3 
Customer object4 


new Customer(); 
object3; 


此 代码 创建 了 两 个 对 象 引 用 ， 它 们 引用 同一 个 对 象 。 因 此 ， 通 过 object3 对 对 象 所 
做 的 任何 更 改 都 将 反映 在 随后 使 用 的 object4 中 。 由 于 基于 类 的 对 象 是 按 引用 来 引 
用 的 ， 因 此 类 称 为 引用 类 型 。 


继承 是 通过 使 用 “派生 ”来 实现 的 ， 而 派生 意味 着 类 是 使 用 “ 基 类 ”声明 的 ， 它 的 数据 和 
行为 从 基 类 继承 。 通 过 在 派生 的 类 名 后 面 追加 冒号 和 基 类 名 称 ， 可 以 指定 基 类 ， 如 
FB: 


public class Manager : Employee 
// Employee fields, properties, methods and events are inherit: 
// New Manager fields, properties, methods and events go here. 
加 更 
当 类 声明 基 类 时 ， 它 继承 基 类 除 构 造 画 数 以 外 的 所 有 成 员 。 


与 C++ 不 同 ，C# 中 的 类 只 能 直接 从 一 个 基 类 继承 。 但 是 ， 因 为 基 类 自身 也 可 能 
承 自 另 一 个 类 ， PELA SAE RST 。 而且， Tee a 
上 的 接口 。 有 关 更 多 信息 ， 请 参见 接口 ee RED) 。 


类 可 以 声明 为 抽象 类 。 抽 象 类 包含 具有 签名 定义 但 没有 实现 的 抽象 方法 。 抽 象 类 不 
能 进行 实例 化 。 只 能 通过 实现 抽象 方法 的 派生 ni poe 密封 类 不 
有 关 更 多 信息 ， 请 参见 见 抽象 关 、 密 类 成 员 (CH 编程 
BPA) o 


类 定义 可 在 不 同 的 源 文件 之 间 进 行 拆 分 。 有 关 更 多 信息 ， 请 参见 分 部 类 和 方法 (CH 
编程 指南 ) o 


fia ah 


下 面 的 示例 中 定义 了 一 个 公共 类 ， 其 中 包含 一 个 字段 、 一 个 方法 和 一 个 称 为 构造 画 
数 的 特殊 方法 。 有 关 更 多 信息 ， 请 参见 构造 国 数 (CH 编程 指南 ) 。 然 后 使 用 new 
关键 字 将 该 类 实例 化 。 





public class Person 


{ 
// Field 
public string name; 
// Constructor that takes no arguments. 
public Person() 
{ 
name = "unknown"; 
j 
// Constructor that takes one argument. 
public Person(string nm) 
{ 
name = nm; 
} 
// Method 
public void SetName(string newName) 
{ 
name = newName; 
} 
} 
class TestPerson 
{ 
static void Main() 
{ 
// Call the constructor that has no parameters. 
Person personi = new Person(); 
Console.WriteLine(personi.name); 
personi.SetName("John Smith"); 
Console.WriteLine(personi.name); 
// Call the constructor that has one parameter. 
Person person2 - new Person("Sarah Jones"); 
Console.WriteLine(person2.name); 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
j 
} 
// Output: 


// unknown 
// John Smith 
// Sarah Jones 
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有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 

C# 编程 指南 

面向 对 象 的 编程 (C# 和 Visual Basic) 

ZAM (CH 编程 指南 ) 

RA (CH 编程 指南 ) 

方法 (CH 编程 指南 ) 

ISR (CH 编程 指南 ) 


析 构 函数 (CH 编程 指南 ) 
对 象 (CH 编程 指南 ) 


类 (CH 编程 指南 ) 
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对 象 (CH 编程 指责) 


类 或 结构 定义 的 作用 类 似 于 蓝图 ， 指 定 该 类 型 可 以 进行 哪些 操作 。 从 本 质 上 说 ， 对 
象 是 按照 此 蓝图 分 配 和 配置 的 内 存 块 。 程 序 可 以 创建 同一 个 类 的 多 个 对 象 。 对 象 也 
称 为 实例 ， 可 以 存储 在 命名 变量 中 ， 也 可 以 存储 在 数组 或 集合 中 。 使 用 这 些 变量 来 
调用 对 象 方法 及 访问 对 象 公共 属性 的 代码 称 为 客户 端 代码 。 在 C# 等 面向 对 象 的 语 
言 中 ， 典 型 的 程序 由 动态 交互 的 多 个 对 象 组 成 。 


ł 


u x 
静态 类 型 的 行为 与 此 处 介绍 的 不 同 。 有 关 更 多 信息 ， 请 参见 静态 类 和 静态 类 成 
A (CH 编程 指南 ) o 


ell 


^ 


结构 实例 。. 选 件 类 实例 


由 于 类 是 引用 类 型 ， 因 此 类 对 象 的 变量 引用 该 对 象 在 托管 堆 上 的 地 址 。 如 果 将 同一 
类 型 的 第 二 个 对 象 分 配给 第 一 个 对 象 ， 则 两 个 变量 都 引用 该 地 址 的 对 象 。 这 一 点 将 
在 本 主题 后 面部 分 进行 更 详细 的 讨论 。 


类 的 实例 是 使 用 new 运算 符 创 建 的 。 在 下 面 的 示例 中 ，Person 为 类 型 ，person1 
和 person 2 为 该 类 型 的 实例 ( 即 对 象 ) 。 


public class Person 


{ 
public string Name { get; set; } 
public int Age { get; set; } 
public Person(string name, int age) 
{ 
Name = name; 
Age = age; 
} 
//Other properties, methods, events... 
} 
class Program 
{ 
static void Main() 
{ 
Person personi = new Person("Leopold", 6); 
Console.WriteLine("personi Name = (0) Age = {1}", personi.! 
// Declare new person, assign personi to it. 
Person person2 - personi; 
//Change the name of person2, and personi also changes. 
person2.Name - "Molly"; 
person2.Age - 16; 
Console.WriteLine("person2 Name = (0) Age = {1}", person2.! 
Console.WriteLine("personi Name = (0) Age = {1}", personi.! 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
JES 
Output: 
person1 Name = Leopold Age = 6 
person2 Name = Molly Age = 16 
personi Name = Molly Age = 16 
2 





由 于 结构 是 值 类 型 ， 因 此 结构 对 象 的 变量 具有 整个 对 象 的 副本 。 结 构 的 实例 也 可 以 
使 用 new 运算 符 来 创建 ， 但 这 不 是 必需 的 ， 如 下 面 的 示例 所 示 : 


public struct Person 


{ 
public string Name; 
public int Age; 
public Person(string name, int age) 
{ 
Name = name; 
Age = age; 
} 
} 
public class Application 
{ 
static void Main() 
{ 
// Create struct instance and initialize by using "new". 
// Memory is allocated on thread stack. 
Person p1 = new Person("Alex", 9); 
Console.writeLine("p1 Name = {0} Age = {1}", pi.Name, p1.Aç 
// Create new struct object. Note that struct can be inil 
// without using "new". 
Person p2 = p1; 
// Assign values to p2 members. 
p2.Name = "Spencer"; 
p2.Age = 7; 
Console.WriteLine("p2 Name = (0) Age = {1}", p2.Name, p2.A¢ 
// pi values remain unchanged because p2 is copy. 
Console.WriteLine("pi Name = (0) Age = {1}", pi.Name, p1.Ac 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
Vas 
Output: 
pi Name - Alex Age - 9 
p2 Name - Spencer Age - 7 
pi Name - Alex Age - 9 
“HY 





p1 和 p2 的 内 存在 线程 堆栈 上 进行 分 配 。 该 内 存 随 声 明 它 的 类 型 或 方法 一 起 回收 。 
这 就 是 在 赋值 时 复制 结构 的 一 个 原因 。 相 比 之 下 ， 当 对 类 实例 对 象 的 所 有 引用 都 超 
出 范围 时 ， 为 该 类 实例 分 配 的 内 存 将 由 公共 语言 运行 时 自动 回收 〈 垃 圾 回收 ) 。 无 
法 像 在 C++ 中 那样 明确 地 销毁 类 对 象 。 有 关 .NET Framework 中 的 垃圾 回收 的 更 
多 信息 ， 请 参见 Garbage Collection。 


y 
Ef TER 


公共 语言 运行 时 中 高 度 优化 了 托管 堆 上 内 存 的 分 配 和 释放 。 在 大 多 数 情况 下 ， 
在 堆 上 分 配 类 实例 与 在 堆栈 上 分 配 结构 实例 在 性 能 开销 上 没有 显著 的 差别 。 


对 象 标 识 与 . 值 相等 性 


在 比较 两 个 对 象 是 否 相 等 时 ， 首 先 必须 明确 您 是 想 知道 两 个 变量 是 否 表示 内 存 中 的 
同一 对 象 ， 还 是 想 知道 这 两 个 对 象 的 一 个 或 多 个 字段 的 值 是 否 相 等 。 如 果 您 要 对 值 
进行 比较 ， 则 必须 考虑 这 两 个 对 象 是 值 类 型 (结构 ) 的 实例 ， 还 是 引用 类 型 (X, 
委托 、 数 组 ) 的 实例 。 
e 若 要 确定 两 个 类 实例 是 否 引用 内 存 中 的 同一 位 置 (意味 着 它们 具有 相同 的 标 
识 ) ， 可 使 用 静态 Equals 方法 。 (System.Object 是 所 有 值 类 型 和 引用 类 型 的 
隐 式 基 类 ， 其 中 包括 用 户 定 义 的 结构 和 类 。) 


e 若 要 确定 两 个 结构 实例 中 的 实例 字段 是 否 具 有 相同 的 值 ， 可 使 用 
ValueType.Equals 方法 。 由 于 所 有 结构 都 隐 式 继承 自 System.ValueType， 因 
此 可 以 直接 在 对 象 上 调用 该 方法 ， 如 下 面 的 示例 所 示 : 


// Person is defined in the previous example. 
//public struct Person 


// public string Name; 
// public int Age; 


// public Person(string name, int age) 
7 1 

// Name = name; 

// Age = age; 

// } 

//} 

Person p1 = new Person("Wallace", 75); 
Person p2; 

p2.Name - "Wallace"; 

p2.Age - 75; 


if (p2.Equals(p1)) 
Console.WriteLine("p2 and pi have the same values."); 


// Output: p2 and pi have the same values. 


Equals 的 System.ValueType 实现 使 用 反射 ， 因 为 它 必须 能 够 确定 任何 结构 中 有 哪 
些 字段 。 在 创建 您 自己 的 结构 时 ， 重 写 Equals 方法 可 以 提供 针对 您 的 类 型 的 高 效 
求 等 算法 。 


e 要 确定 两 个 类 实例 中 字段 的 值 是 否 相等 ， 您 可 以 使 用 Equals 方法 或 == 运算 
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符 。 但 是 ， 只 有 类 通过 已 重 写 或 重 载 提供 关于 那 种 类 型 对 象 的 相等 含义 的 自 定 
义 时 ， 才 能 使 用 它们 。 类 也 可 以 实现 IEquatable<T> 接口 或 
IEqualityComparer<T> 接口 。 这 两 个 接口 都 提供 可 用 于 测试 值 相等 性 的 方 
法 。 设 计 好 重 写 Equals 的 类 后 ， 请 务必 遵循 如 何 : 为 类 型 定义 值 相 等 性 (CH 
编程 指南 ) 和 Object.Equals(Object) 中 介绍 的 准则 。 


相关 章节 
有 关 更 多 信息 : 
e X (CH 编程 指南 ) 
e 结构 (CH 编程 指南 ) 
e ÈRA (CH 编程 指南 ) 
o MER (CH 编程 指南 ) 
e 事件 (CH 编程 指南 ) 
请 参阅 
C# 编程 指南 
object (C£ 参考 ) 
继承 (CH 编程 指南 ) 
class (C# 参考 ) 
struct (C£ 参考 ) 
new 运算 符 〈C# 参考 ) 
常规 类 型 系统 


vc 
T Bl 
NO 


结构 (CH 编程 指南 ) 


结构 是 使 用 struct 关键 字 定 义 的 ， 例 如 : 


public struct PostalAddress 


// Fields, properties, methods and events go here... 


结构 与 类 共享 大 多 数 相同 的 语法 ， 但 结构 比 类 受到 的 限制 更 多 : 


企 结 构 声 明 中 ， 除 非 字 段 被 声明 为 const Ek static， 否 则 无 法 初始 化 。 
结构 不 能 声明 默认 构造 男 数 (没有 参数 的 构造 画 数 ) 或 析 构 函数 。 
结构 在 赋值 时 进行 复制 。 将 结构 赋值 给 新 变量 时 ， 将 复制 所 有 数据 ， 并 且 对 新 
副本 所 做 的 任何 修改 不 会 更 改 原始 副本 的 数据 。 在 使 用 值 类 型 的 集合 (如 
Dictionary<string, myStruct>) 时 ， 请 务必 记 住 这 一 点 。 
结构 是 值 类 型 ， 而 类 是 引用 类 型 。 
与 类 不 同 ， 结 构 的 实例 化 可 以 不 使 用 new 运算 符 。 

结构 可 以 声明 带 参数 的 构造 男 数 。 


一 个 结构 不 能 从 另 一 个 结构 或 类 继承 ， 而 且 不 能 作为 一 个 类 的 基 。 所 有 结构 都 
直接 继承 自 System.ValueType， 后 者 继承 自 System. D 


结构 可 以 实现 接口 。 
结构 可 用 作 可 以 为 null 的 类 型 ， 因 而 可 向 其 赋 null 值 。 


相关 章节 


有 关 更 多 信息 


使 用 结构 (CH 编程 指南 ) 

MOSES (CH 编程 指南 ) 

可 以 为 null 的 类 型 (C# 编程 指南 ) 

如 何 : 了 解 向 方法 传递 结构 和 向 方法 传递 类 引用 之 间 的 区 别 (CH 编程 指南 ) 
如 何 : 在 结构 间 实 现 用 户 定义 的 转换 (CH 编程 指南 ) 

More About Variables 在 Beginning Visual C# 2010 
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请 人 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 
X (CH 编程 指南 ) 


结构 (CH 编程 指南 ) 
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继承 (CH 编程 指南 ) 


继承 〈 加 上 封装 和 多 态 性 ) 是 面向 对 象 的 编程 的 三 个 主要 特性 (也 称 为 “支柱 ”) 之 
一 。 继承 用 于 创建 可 重用 、 扩 展 和 修改 在 其 他 类 中 定义 的 行为 的 新 类 。 其 成 员 被 继 
承 的 类 称 为 “ 基 类 ”， 继 承 这 些 成 员 的 类 称 为 “派生 类 ”。 派 生 类 只 能 有 一 个 直接 基 类 。 
但 是 ， 继 承 是 可 传递 的 。 如 果 ClassB 派生 出 ClassC, ClassA 派生 出 ClassB， 则 
ClassC 会 继承 ClassB 和 ClassA 中 声明 的 成 员 。 


i Eu 
W LER 


结构 不 支持 继承 ， 但 可 以 实现 接口 。 有 关 更 多 信息 ， 请 参见 HO (CH 编程 指 


南 ) 。 


从 概念 上 来 说 ， 派 生 类 是 基 类 的 特例 。 例如 ， 如 果 您 有 一 个 基 类 Animal， 则 可 以 
有 一 个 名 为 Mammal 的 派生 类 和 一 个 名 为 Reptile 的 派生 类 。 Mammal 是 一 个 
Animal, Reptile 也 是 一 个 Animal， 但 每 个 派生 类 均 表 示 基 类 的 不 同 专用 化 。 


定义 一 个 类 从 其 他 类 派生 时 ， 派 生 类 隐 式 获得 基 类 的 除 构 造 钞 数 和 析 构 函数 以 外 的 
所 有 成 员 。 因 此 ， 派 生 类 可 以 重用 基 类 中 的 代码 而 无 需 重新 实现 这 些 代码 。 可 以 在 
派生 类 中 添加 更 多 成 员 。 派 生 类 以 这 种 方式 扩展 基 类 的 功能 。 


下 图 演示 一 个 Workltem 类 ， 该 类 表示 某 业务 流程 中 的 一 个 工作 项 。 和 所 有 的 类 一 
样 ， 该 类 派生 自 System.Object 并 继承 其 所 有 方法 。 Workltem 添加 了 自己 的 五 个 
成 员 。 其 中 包括 一 个 构造 琅 数 ， 因 为 构造 男 数 不 能 继承 。 类 ChangeRequest 继承 
自 Workltem 并 表示 特定 种 类 的 工作 项 。 ChangeRequest 在 它 从 Workltem 和 
Object 继承 的 成 员 中 另外 添加 了 两 个 成 员 。 它 必须 添加 其 自己 的 构造 画 数 ， 还 添加 
originalltemID。 利 用 属性 originalltemID， 可 将 ChangeRequest 实例 与 更 改 请 求 将 
应 用 到 的 原始 Workltem 相关 联 。 


We Workltem : 对 象 ChangeRequest : WorkItem 





F Equals() 





Finalize() 
GetHashCode() 
GetType() 








MemberwiseClone() 
ReferenceEquals() 





ToString() 
int ID 
string Title 
项 TimeSpan jobLength 
TESTIT Update() 
WorkItem() 


| intoriginalltemID 


ChangeRequest() 





下 面 的 示例 演示 如 何以 C# 表示 上 图 所 示 的 类 关系 。 该 示例 还 演示 Workltem 如 何 
重 写 虚 方法 Object.ToString， 以 及 ChangeRequest 类 如 何 继承 该 方法 的 
Workltem 实现 。 


// WorkItem implicitly inherits from the Object class. 
public class WorkItem 


( 


// Static field currentID stores the job ID of the last WorkIte 
// has been created. 
private static int currentID; 


//Properties. 

protected int ID { get; set; } 

protected string Title { get; set; } 
protected string Description ( get; set; ) 
protected TimeSpan jobLength { get; set; } 


// Default constructor. If a derived class does not invoke a b: 
// class constructor explicitly, the default constructor is ca: 
// implicitly. 

public WorkItem() 


{ 
ID = 0; 
Title = "Default title"; 
Description = "Default description."; 
jobLength = new TimeSpan(); 
} 


// Instance constructor that has three parameters. 
public WorkItem(string title, string desc, TimeSpan joblen) 
{ 
this.ID = GetNextID(); 
this.Title = title; 
this.Description = desc; 
this.jobLength = joblen; 
} 


// Static constructor to initialize the static member, current: 
// constructor is called one time, automatically, before any ir 
// of WorkItem or ChangeRequest is created, or currentID is ret 
static WorkItem() 


{ 
currentID = 0; 
j 
protected int GetNextID() 
{ 


// currentID is a static field. It is incremented each time 
// instance of WorkItem is created. 
return ++currentID; 


j 


// Method Update enables you to update the title and job lengtt 
// existing WorkItem object. 
public void Update(string title, TimeSpan joblen) 
{ 
this.Title = title; 
this.jobLength - joblen; 
j 


// Virtual method override of the ToString method that is inhei 
// from System.Object. 
public override string ToString() 


{ 
} 


return String.Format("{0} - {1}", this.ID, this.Title); 


// ChangeRequest derives from WorkItem and adds a property (origin: 
// and two constructors. 
public class ChangeRequest : WorkItem 


i 


} 


protected int originalltemID { get; set; } 


// Constructors. Because neither constructor calls a base-clas: 
// constructor explicitly, the default constructor in the base 
// is called implicitly. The base class must contain a default 
// constructor. 


// Default constructor for the derived class. 
public ChangeRequest() { } 


// Instance constructor that has four parameters. 

public ChangeRequest(string title, string desc, TimeSpan jobLer 
int originalID) 

{ 


// The following properties and the GetNexID method are inl 
// from WorkItem. 

this.ID - GetNextID(); 

this.Title - title; 

this.Description - desc; 

this.jobLength - jobLen; 


// Property originalItemId is a member of ChangeRequest, bi 
// of WorkItem. 
this.originalItemID = originalID; 


class Program 


{ 


static void Main() 


// Create an instance of WorkItem by using the constructor 
// base class that takes three arguments. 


WorkItem item - new WorkItem("Fix Bugs", 
"Fix all bugs in my code bran 
new TimeSpan(3, 4, 0, 0)); 


// Create an instance of ChangeRequest by using the constrt 

// the derived class that takes four arguments. 

ChangeRequest change - new ChangeRequest("Change Base Clas: 
"Add members to tl 
new TimeSpan(4, 0, 
1); 


// Use the ToString method defined in WorkItem. 
Console.WriteLine(item.ToString()); 


// Use the inherited Update method to change the title of 1 
// ChangeRequest object. 
change.Update("Change the Design of the Base Class", 

new TimeSpan(4, 0, 0)); 


// ChangeRequest inherits WorkItem's override of ToString. 
Console.WriteLine(change.ToString()); 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


j 


} 
/* Output: 

1 - Fix Bugs 

2 - Change the Design of the Base Class 
a 
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抽象 方法 和 虚 方 法 


当 基 类 将 方法 声明 为 virtual 时 ， 派 生 类 可 以 用 自己 的 实现 重 写 该 方法 。 如 果 基 类 将 
成 员 声 明 为 abstract， 则 在 直接 继承 自 该 类 的 任何 非 抽象 类 中 都 必须 重 写 该 方法 。 

如 果 派 生 类 自身 是 抽象 的 ， 则 它 继承 抽象 成 员 而 不 实现 它们 。 抽 象 成 员 和 虚 成 员 是 
多 态 性 的 基础 ， 多 态 性 是 面向 对 象 的 编程 的 第 二 个 主要 特性 。 有 关 更 多 信息 ， 请 参 
SAM (CH 编程 指南 ) o 


抽象 基 类 


如 果 希 望 禁 止 通 过 new 关 键 字 直 接 进 行 实例 化 ， 可 以 将 类 声明 为 abstract 如 果 这 样 
做 ， 则 仅 当 从 该 类 派生 新 类 时 才能 使 用 该 类 。 抽 象 类 可 以 包含 一 个 或 多 个 自身 声明 
为 抽象 的 方法 签名 。 这 些 签 名 指定 参数 和 返回 值 ， 但 没有 实现 (方法 体 ) 。 抽 象 类 





不 必 包 含 抽象 成 员 ; 但 是 ， 如 果 某 个 类 确实 包含 抽象 成 员 ， 则 该 类 自身 必须 声明 为 
抽象 类 。 自 身 不 是 抽象 类 的 派生 类 必须 为 抽象 基 类 中 的 任何 抽象 方法 提供 实现 。 有 
关 更 多 信息 ， 请 参见 抽象 类 、 密 封 类 及 类 成 员 (C# 编程 指南 ) o 


接口 


“接口 "是 一 种 引用 类 型 ， 有 点 像 仅 包含 抽象 成 员 的 抽象 基 类 。 类 在 从 接口 实现 时 必 
须 为 该 接口 的 所 有 成 员 提供 实现 。 类 虽然 只 能 从 一 个 直接 基 类 派生 ， 但 可 以 实现 多 
个 接口 。 


接口 用 于 为 不 一 定 具有 “是 ”关系 的 类 定义 特定 功能 。 例 如 ，System.lEquatable<T> 
接口 可 由 任何 类 或 构造 实现 ， 这 些 类 或 构造 必须 启用 代码 来 确定 该 类 型 的 两 个 对 象 
是 否 等 效 (但 是 该 类 型 定义 等 效 性 ) 。 IEquatable<T> 不 表示 基 类 和 派生 类 之 间 存 
在 的 同一 种 “是 ”关系 (例如 Mammal 是 Animal) 。 有 关 更 多 信息 ， 请 参见 接口 
(C# 编程 指南 ) 。 


派生 类 对 基 类 成 员 的 访问 
派生 类 可 以 访问 基 类 的 公共 成 员 、 受 保护 成 员 、 内 部 成 员 和 受 保护 内 部 成 员 。 即 使 
派生 类 继承 基 类 的 私有 成 员 ， 仍 不 能 访问 这 些 成 员 。 但 是 ， 所 有 这 些 私有 成 员 在 派 


生 类 中 仍然 存在 ， 且 执行 与 基 类 自身 中 相同 的 工作 。 例 如 ， 假 定 一 个 受 保护 基 类 方 
法 访问 私有 字段 。 要 使 继承 的 基 类 方法 正常 工作 ， 派 生 类 中 必须 有 该 字段 。 


系 止 进一步 派生 


类 可 以 将 自身 或 其 成 员 声 明 为 sealed， 从 而 禁止 其 他 类 从 该 类 自身 或 其 任何 成 员 继 
承 。 有 关 更 多 信息 ， 请 参见 抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) o 


派生 类 隐藏 基 类 成 员 


派生 类 可 以 通过 以 相同 的 名 称 和 签名 声明 基 类 成 员 来 隐藏 这 些 成 员 。 可 以 使 用 new 
修饰 符 显 式 指示 成 员 不 作为 基 类 成 员 的 重 写 。 不 是 必须 要 使 用 new， 但 如 果 不 使 用 
new， 将 生成 编译 器 警告 。 有 关 更 多 信息 ， 请 参见 使 用 Override 和 New 关键 字 进 

1 (CH 编程 指南 ) 和 了 解 何 时 使 用 Override 和 New 关键 字 (CH 编程 指 
南 ) 。 


CH 编程 指南 
类 和 结构 (CH 编程 指南 ) 
class (C£ 参考 ) 
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struct (C£ 参考 ) 


继承 (CH 编程 指南 ) 
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多 态 性 (CH 编程 指南 ) 


多 态 性 常 被 视 为 自封 装 雪 和 继承 之 后 B, 面向 对 象 的 编程 的 第 三 个 支柱 。 
Polymorphism (多 态 性 ) 是 一 个 希腊 词 ， 指 “多 种 形态 ”， 多 态 性 具有 两 个 截然 不 同 
的 方面 : 


e 在 运行 时 ， 在 方法 参数 和 集合 或 数组 等 位 置 ， 派 生 类 的 对 象 可 以 作为 基 类 的 对 
象 处理。 发 生 此 情况 时 ， 该 对 象 的 声明 类 型 不 再 与 运行 时 类 型 相同 。 


e 基 类 可 以 定义 并 实现 虚 方 法 ， 派 生 类 可 以 重 写 这 些 方 法 ， 即 派生 类 提供 自己 的 
定义 和 实现 。 在 运行 时 ， 客 户 端 代 码 调 用 该 方法 ，CLR 查找 对 象 的 运行 时 类 
型 ， 并 调用 虚 方 法 的 重 写 方 法 。 因 此 ， 你 可 以 在 源 代码 中 调用 基 类 的 方法 ， 但 
执行 该 方法 的 派生 类 版 本 。 


虚 方 法 允许 你 以 统一 方式 处 理 多 组 相关 的 对 象 。 例 如 ， 假 定 你 有 一 个 绘图 应 用 程 
序 ， 人 允许 用 户 在 绘图 图 面 上 创建 各 种 形状 。 你 在 编译 时 不 知道 用 Rel 建 哪 些 特定 
类 型 的 形状 。 但 应 用 程序 必须 跟踪 创建 的 所 有 类 型 的 形状 ， 并 且 必 须 更 新 这 些 形状 
以 响应 用 户 鼠 标 操作 。 你 可 以 使 用 多 态 性 通过 两 个 基本 步骤 解决 这 一 问题 : 


.创建 一 个 类 层次 结构 ， 其 中 每 个 特定 形状 类 均 派生 自 一 个 公共 基 类 。 
2. 使 用 虚 方 法 通过 对 基 类 方法 的 单个 调用 来 调用 任何 派生 类 上 的 相应 方法 。 


首先 ， 创 建 一 个 名 为 Shape 的 基 类 ， 并 创建 一 些 派生 类 ， 例 如 Rectangle. Circle 
和 Triangle。 为 Shape 类 提供 一 人 Bo Draw 的 虚 方 法 ， 并 在 每 个 派生 类 中 重 写 该 
方法 以 绘制 该 类 表示 的 特定 形状 。 创 建 一 个 List<Shape> 对 象 ， 并 向 该 对 象 添加 
Circle, Triangle 和 Rectangle。 若 要 更 新 绘图 图 面 ， 请 使 用 foreach rco DIR 
进行 循环 访问 ， 并 对 其 中 的 每 个 Shape 对 象 调用 Draw 方法 。 虽 然 列 表 中 的 每 个 对 
SE TA 类 型 Shape， 但 调用 的 将 是 运行 时 类 型 (该 方法 在 每 个 派生 类 中 的 重 
BRA) o 


public class Shape 


// A few example members 

public int X { get; private set; } 
public int Y ( get; private set; ) 
public int Height ( get; set; } 
public int width { get; set; } 


// Virtual method 
public virtual void Draw() 


i 
t 


Console.WriteLine("Performing base class drawing tasks"); 


} 
class Circle : Shape 


public override void Draw() 


// Code to draw a circle... 
Console.WriteLine("Drawing a circle"); 
base.Draw(); 
j 
j 
class Rectangle : Shape 
{ 
public override void Draw() 
{ 
// Code to draw a rectangle... 
Console.WriteLine("Drawing a rectangle"); 
base.Draw(); 
j 
j 
class Triangle : Shape 


( 


public override void Draw() 


// Code to draw a triangle... 
Console.WriteLine("Drawing a triangle"); 
base.Draw(); 


} 


class Program 


static void Main(string[] args) 


i 


// Polymorphism at work £1: a Rectangle, Triangle and Circ. 
// can all be used whereever a Shape is expected. No cast : 
// required because an implicit conversion exists from a dt 


// class to its base class. 


System.Collections.Generic.List«Shape» shapes 


shapes.Add(new Rectangle()); 
shapes.Add(new Triangle()); 
shapes.Add(new Circle()); 


new System 


// Polymorphism at work £2: the virtual method Draw is 


// invoked on each of the derived classes, 


foreach (Shape s in shapes) 


{ 
} 


// Keep the console open in debug mode. 


s.Draw(); 


Console.WriteLine("Press any key to exit."); 


Console.ReadKey(); 


j 


/* Output: 


the base cl: 


Drawing a rectangle 

Performing base class drawing tasks 

Drawing a triangle 

Performing base class drawing tasks 

Drawing a circle 

Performing base class drawing tasks 
zu 


«| = NH 


在 CH 中 ， 每 个 类 型 都 是 多 态 的 ， 因 为 包括 用 户 定义 类 型 在 内 的 所 有 类 型 都 继承 自 
Object。 








多 态 性 概述 
当 派生 类 从 基 类 继承 时 ， 它 会 获得 基 类 的 所 有 方法 、 字 段 、 属 性 和 事件 。 派 生 类 的 


设计 器 可 以 选择 是 否 

e 重 写 基 类 中 的 虚拟 成 员 。 

e 继承 最 接近 的 基 类 方法 而 不 重 写 它 

e 定义 隐藏 基 类 实现 的 成 员 的 新 非 虚实 现 
仅 当 基 类 成 员 声明 为 virtual 或 abstract 时 ， 派 生 类 才能 重 写 基 类 成 员 。 派 生成 员 必 
须 使 用 override 关键 字 显 式 指示 该 方法 将 参与 虚 调 用 。 以 下 代码 提供 了 一 个 示例 : 
public class BaseClass 


public virtual void DoWork() { } 
public virtual int WorkProperty 


{ 
} 


public class DerivedClass : BaseClass 


get { return 0; } 


public override void DoWork() { } 
public override int WorkProperty 


{ 
} 


get { return 0; } 


字段 不 能 是 虚拟 的 ， 只 有 方法 、 属 性 、 事 件 和 索引 器 才 可 以 是 虚拟 的 。 当 派生 类 重 
写 某 个 虚拟 成 员 时 ， 即 使 该 派生 类 的 实例 被 当 作 基 类 的 实例 访问 ， 也 会 调用 该 成 
员 。 以 下 代码 提供 了 一 个 示例 : 


DerivedClass B - new DerivedClass(); 
B.DoWork(); // Calls the new method. 


BaseClass A - (BaseClass)B; 
A.DoWork(); // Also calls the new method. 


虚 方 法 和 属性 允许 派生 类 扩展 基 类 ， 而 无 需 使 用 方法 的 基 类 实现 。 有 关 详 细 信息 ， 
请 参阅 使 用 Override 和 New 关键 字 进 行 版 本 控制 (CH 编程 指南 ) 。 接 口 提 供 另 
一 种 方式 来 定义 将 实现 留 给 派生 类 的 方法 或 方法 集 。 有 关 详 细 信 息 ， 请 参阅 接口 
(C# 编程 指南 ) 。 


使 用 新 成 员 隐 藏 基 类 成 员 

如 果 希 望 派生 成 员 具 有 与 基 类 中 的 成 员 相同 的 名 称 ， 但 又 不 希望 派生 成 员 参 与 虚 调 
用 ， 则 可 以 使 用 new 天 键 字 。 new 关键 字 放置 在 要 蔡 换 的 类 成 员 的 返回 类 型 之 
前 。 以 下 代码 提供 了 一 个 示例 : 


public class BaseClass 


{ 
public void Dowork() { WorkField++; } 
public int WorkField; 
public int WorkProperty 
{ 
get { return 0; } 
} 
} 
public class DerivedClass : BaseClass 
{ 
public new void DoWork() { WorkField++; } 
public new int WorkField; 
public new int WorkProperty 
{ 
get { return 0; } 
} 
} 


通过 将 派生 类 的 实例 强制 转换 为 基 类 的 实例 ， 仍 然 可 以 从 客户 端 代码 访问 隐藏 的 基 
类 成 员 。 例如 


DerivedClass B = new DerivedClass(); 
B.DoWork(); // Calls the new method. 


BaseClass A - (BaseClass)B; 
A.DoWork(); // Calls the old method. 


阻止 派生 类 重 写 虚拟 成 员 
无 论 在 虚拟 成 员 和 最 初 声明 虚拟 成 员 的 类 之 间 已 声明 了 多 少 个 类 ， 虚 拟 成 员 永 远 都 
是 虚拟 的 。 如 果 类 和信 声 明了 一 个 虚拟 成 员 ， 类 B 从 AA 派生， 类 C 从 类 BRE, n 
X C 继承 该 虚拟 成 员 ， 并 且 可 以 选择 重 守 它 ， 而 不 管 类 B 是 否 为 该 成 员 声 明了 重 
写 。 以 下 代码 提供 了 一 个 示例 : 
public class A 
public virtual void DoWork() { } 


public class B : A 


public override void DoWork() ( } 


派生 类 可 以 通过 将 重 写 声明 为 sealed 来 停止 虚拟 继承 。 这 需要 在 类 成 员 声 明 中 的 
override 关键 字 前 面 放置 sealed 关键 字 。 以 下 代码 提供 了 一 个 示例 : 
public class C : B 


public sealed override void DoWork() { } 


在 上 一 个 示例 中 ， 方 法 DoWork 对 从 C 派生 的 任何 类 都 不 再 是 虚拟 方法 。 即 使 它 
们 转换 为 类 型 B 或 类 型 A， 它 对 于 C 的 实例 仍然 是 虚拟 的 。 通 过 使 用 new 关键 
字 ， 密 封 的 方法 可 以 由 派生 类 替换 ， 如 下 面 的 示例 所 示 : 

public class D : C 


public new void DoWork() { } 


在 此 情况 下 ， 如 果 在 D 中 使 用 类 型 为 D 的 变量 调用 DoWork， 被 调用 的 将 是 新 的 
DoWork。 如 果 使 用 类 型 为 C、B 或 A 的 变量 访问 D 的 实例 ， 对 DoWork 的 调用 将 
遵循 虚拟 继承 的 规则 ， 即 把 这 些 调用 传送 到 类 C 的 DoWork 实现 。 


从 派生 类 访问 基 类 虚拟 成 员 


已 替换 或 重 写 某 个 方法 或 属性 的 派生 类 仍然 可 以 使 用 基 关 键 字 访问 基 类 的 该 方法 或 
属性 。 以 下 代码 提供 了 一 个 示例 : 
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public class Base 
public virtual void DoWork() (/*...*/ ) 


public class Derived : Base 


{ 
public override void DoWork() 
{ 
//Perform Derived's work here 
VNETE 
// Call DoWork on base class 
base.DoWork(); 
} 
5 


有 关 详 细 信 息 ， 请 参阅 base. 
区 注意 
建议 虚拟 成 员 在 它们 自己 的 实现 中 使 用 base 来 调用 该 成 员 的 基 类 实现 。 人 允许 基 


类 行为 发 生 使 得 派生 类 能 够 集中 精力 实现 特定 于 派生 类 的 行为 。 未 调用 基 类 实 
现时 ， 由 派生 类 负责 使 它们 的 行为 与 基 类 的 行为 兼容 。 


本 节 内 容 


e 使 用 Override 和 New 关键 字 进 行 版 本 控制 (CH 编程 指南 ) 
e 了 解 何 时 使 用 Override 和 New 关键 字 (CHE 编程 指南 ) 
e 如 何 : BFS ToString 方法 (CH 编程 指南 ) 


请 参阅 

C# 编程 指南 

C# 编程 指南 

继承 (C# 编程 指南 ) 

抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) 
方法 (CH 编程 指南 ) 

事件 (CH 编程 指南 ) 

属性 (CH 编程 指南 ) 

RAIAT (CH 编程 指南 ) 


ZANE (CH 编程 指南 ) 86 
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类 型 (CH 编程 指南 ) 


SAVE (CH 编程 指南 ) 
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抽象 类 、 密 封 类 及 类 成 员 〈C# 编程 指南 ) 


使 用 abstract 关键 字 可 以 创建 不 完整 且 必 须 在 派生 类 中 实现 的 类 和 类 成 员 。 
使 用 sealed 关键 字 可 以 防止 继承 以 前 标记 为 virtual 的 类 或 某 些 类 成 员 。 


通过 在 类 定义 前 面 放置 关键 字 abstract， 可 以 将 类 声明 为 抽象 类 。 例 如 : 


public abstract class A 


// Class members here. 


抽象 类 不 能 实例 化 。 抽 象 类 的 用 途 是 提供 一 个 可 供 多 个 派生 类 共享 的 通用 基 类 定 
义 。 例 如 ， 类 库 可 以 定义 一 个 抽象 类， 将 其 用 作 多 个 类 库 画 数 的 参数 ， 并 要 求 使 用 
该 库 的 程序 员 通 过 创建 派生 类 来 提供 自己 的 类 实现 。 

抽象 类 也 可 以 定义 抽象 方法 。 方 法 是 将 关键 字 abstract 添加 到 方法 的 返回 类 型 的 
前 面 。 例 如 : 


public abstract class A 


public abstract void DoWork(int i); 


抽象 方法 没有 实现 ， 所 以 方法 定义 后 面 是 分 号 ， 而 不 是 常规 的 方法 块 。 抽 象 类 的 派 
生 类 必须 实现 所 有 抽象 方法 。 当 抽象 类 从 基 类 继承 虚 方法 时 ， 抽 象 类 可 以 使 用 抽象 
方法 重 写 该 虚 方法 。 例 如 : 


// compile with: /target:library 
public class D 


{ 
public virtual void DoWork(int i) 
// Original implementation. 
} 
} 
public abstract class E : D 
{ 
public abstract override void DoWork(int i); 
j 
public class F : E 
{ 
public override void DoWork(int i) 
{ 
// New implementation. 
} 
} 


如 果 将 virtual 方法 声明 为 abstract， 则 该 方法 对 于 从 抽象 类 继承 的 所 有 类 而 言 仍 
然 是 虚 方 法 。 继 承 一 个 抽象 方法 的 类 不 能 访问 该 方法 的 原始 实现 。 在 上 一 个 示例 
rh, 3 F 中 的 DoWork 不 能 调用 类 D 中 的 DoWork。 通 过 这 种 方式 ， 抽 象 类 可 以 
强制 派生 类 为 虚 方法 提供 新 的 方法 实现 。 


ra +- xp wp X. 
密封 类 和 类 成 员 
通过 在 类 定义 前 面 放置 关键 字 sealed， 可 以 将 类 声明 为 密封 类 。 例 如 : 


public sealed class D 


// Class members here. 


密封 类 不 能 用 作 基 类 。 因 此 ， 它 也 不 能 是 抽象 类 。 密 封 类 禁止 派生 。 由 于 密封 类 从 
不 用 作 基 类 ， 所 以 有 些 运行 时 优化 可 以 略微 提高 密封 类 成 员 的 调用 速度 。 

在 对 基 类 的 虚 成 员 进 行 重 写 的 派生 类 上 ， 方 法 、 索 引 器 、 属 性 或 事件 可 以 将 该 成 员 
声明 为 密封 成 员 。 在 用 于 以 后 的 派生 类 时 ， 这 将 取消 成 员 的 虚 效 果 。 方 法 是 在 类 成 
员 声 明 中 将 sealed 关键 字 置 于 override 关键 字 的 前 面 。 例 如 : 
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public class D : C 


public sealed override void DoWork() { } 


CH TEH E 

类 和 结构 (CH 编程 指南 ) 

继承 (CH 编程 指南 ) 

方法 (CH 编程 指南 ) 

字段 (CH 编程 指南 ) 

如 何 : 定义 抽象 属性 (CH 编程 指南 ) 


抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) 
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态 类 和 静态 类 成 员 (CH 编程 指南 ) 


静态 类 与 非 静 态 类 基本 相同 ， 但 存在 一 个 区 别 : 静态 类 不 能 实例 化 。 也 就 是 说 ， 不 
能 使 用 new 关键 字 创 建 静态 类 类 型 的 变量 。 因 为 没有 实例 变量 ， 所 以 要 使 用 类 名 本 
身 访问 静态 类 的 成 员 。 例 如 ， 如 果 名 为 UtilityClass 的 静态 类 有 一 个 名 为 MethodA 
的 公共 方法 ， 则 按 下 面 的 示例 所 示 调 用 该 方法 : 


UtilityClass.MethodA(); 


对 于 只 对 输入 参数 进行 运算 而 不 获取 或 设置 任何 内 部 实例 字段 的 方法 集 ， 静 态 类 五 
以 方便 地 用 作 这 些 方法 集 的 容器 。 例 如 ， 在 .NET Framework 类 库 中 ， 静 态 类 
System.Math 包含 的 方法 只 执行 数学 运算 ， 而 无 需 存 储 或 检索 特定 Math 类 实例 特 
有 的 数据 。 就 是 说 ， 通 过 指定 类 名 称 和 方法 名 称 来 应 用 类 成 员 ， 如 下 示例 所 述 。 


double dub = -3.14; 
Console.WriteLine(Math.Abs(dub)); 
Console.WriteLine(Math.Floor(dub)); 
Console.WriteLine(Math.Round(Math.Abs(dub))); 


// Output: 
// 3.14 
// -4 
47-3 


和 所 有 类 类 型 一 样 ， 当 加 载 引 用 静态 类 的 程序 时 ，.NET Framework 公共 语言 运行 
at (CLR) 将 加 载 该 静态 类 的 类 型 信息 。 程 序 不 能 指定 加 载 静态 类 的 确切 时 间 。 但 

是 ， 可 以 保证 在 程序 中 首次 引用 该 类 前 加 载 该 类 ， 并 初始 化 该 类 的 字段 并 调用 其 静 
态 构 造 图 数 。 静 态 构造 画 数 仅 调 用 一 次 ， 在 程序 驻 留 的 应 用 程序 域 的 生存 期 内 ， 静 
态 类 一 直 保 留 在 内 存 中 。 

8 注意 


若 要 创建 仅 人 允许 创建 一 个 自身 实例 的 非 静 态 类 ， 请 参见 Implementing Singleton 
in C# (在 C# 中 实现 单一 实例 ) 。 


下 表 介 绍 静 态 类 的 主要 特性 : 
。 仅 包含 静态 成 员 。 
。 无 法 实例 化 。 
e 是 密封 的 。 


。 TEZA ZIERA. 


Atl, ees X G6 ESCOLAR ER S DX, A MMA AERA ABA MAMIE 
函数 阻止 类 被 实例 化 。 使 用 静态 类 的 优点 在 于 ， 编 译 器 能 够 执行 检查 以 确保 不 致 偶 
然 地 添加 实例 成 员 。 编 译 器 将 保证 不 会 创建 此 类 的 实例 。 


静态 类 是 密封 的 ， 因 此 不 可 被 继承 。 它 们 不 能 从 除 Object 外 的 任何 类 中 继承 。 静 
态 类 不 能 包含 实例 构造 画 数 ， 但 可 以 包含 静态 构造 画 数 。 如 果 非 静态 类 包含 需要 进 
行 重要 的 初始 化 的 静态 成 员 ， 也 应 定义 静态 构造 画 数 。 有 关 更 多 信息 ， 请 参见 静态 
Mieke (CH 编程 指南 ) o 


下 面 是 一 个 静态 类 的 示例 ， 它 包含 两 个 在 摄氏 温度 和 华氏 温度 之 间 执 行 来 回转 换 的 
方法 : 


public static class TemperatureConverter 


{ 
public static double CelsiusToFahrenheit(string temperatureCel: 
{ 
// Convert argument to double for calculations. 
double celsius = Double.Parse(temperatureCelsius); 
// Convert Celsius to Fahrenheit. 
double fahrenheit = (celsius * 9 / 5) + 32; 
return fahrenheit; 
} 
public static double FahrenheitToCelsius(string temperatureFahı 
{ 
// Convert argument to double for calculations. 
double fahrenheit = Double.Parse(temperatureFahrenheit ) ; 
// Convert Fahrenheit to Celsius. 
double celsius = (fahrenheit - 32) * 5 / 9; 
return celsius; 
} 
} 


class TestTemperatureConverter 
{ 
static void Main() 
{ 
Console.WriteLine("Please select the convertor direction") , 
Console.WriteLine("1\. From Celsius to Fahrenheit."); 
Console.WriteLine("2\. From Fahrenheit to Celsius."); 
Console.Write(":"); 


string selection = Console.ReadLine(); 
double F, C = 0; 


switch (selection) 


{ 


CAaSsen 


Console.Write("Please enter the Celsius temperatur: 
F = TemperatureConverter.CelsiusToFahrenheit(Conso: 
Console.WriteLine("Temperature in Fahrenheit: {0:F: 
break; 


case "2": 
Console.Write("Please enter the Fahrenheit temperat 
C = TemperatureConverter .FahrenheitToCelsius(Conso- 
Console.WriteLine("Temperature in Celsius: {0:F2}", 
break; 


default: 
Console.WriteLine("Please select a convertor."); 
break; 


} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Example Output: 
Please select the convertor direction 
1\. From Celsius to Fahrenheit. 
2\. From Fahrenheit to Celsius. 
2 
Please enter the Fahrenheit temperature: 20 
Temperature in Celsius: -6.67 
Press any key to exit. 
S 


ES 


静态 成 员 


非 静态 关 可 以 包含 静态 的 方法 、 字 段 、 属 性 或 事件 。 即 使 没有 创建 类 的 实例 ， 也 可 
以 调用 该 类 中 的 误 态 成 员 。 始 从 通过 类 名 而 不 是 实例 名 称 访问 静态 成 员 。 无 论 对 一 
个 类 创建 多 少 个 实例 ， 它 的 静态 成 员 都 只 有 一 个 副本 。 静 坊 方法 和 属性 不 能 访问 其 
含 类 型 中 的 非 静态 字段 和 事件 ， 并 且 不 能 访问 任何 对 象 的 实例 变量 (除非 在 方法 
参数 中 显 式 传递 ) 。 


更 常见 的 做 法 是 声明 具有 一 些 静 态 成 员 的 非 静态 类 ， 是 将 整个 类 声明 为 静态 
类 。 静 态 字 段 有 两 个 常见 的 用 法 : 一 是 记录 已 实例 化 对 象 的 个 数 ， 二 是 存储 必须 在 
所 有 实例 之 间 共 Ez PR, 


静态 方法 可 以 被 重 载 但 不 能 被 重 写 ， 因 为 它们 属于 类 ， 不 属于 类 的 任何 实例 。 


虽然 字段 不 能 声明 为 static const， 但 const 字段 的 行为 在 本 质 上 是 静态 的 。 这 样 的 
字段 属于 类 型 ， 不 属于 类 型 的 实例 。 因 此 ， 可 以 同 对 待 静态 字段 一 样 使 用 
ClassName.MemberName 表示 法 来 访问 const 字段 。 不 需要 对 象 实例 。 





C# 不 支持 静态 局 部 变量 〈 在 方法 范围 内 声明 的 变量 ) 。 


通过 在 成 员 的 返回 类 型 之 前 使 用 static 关键 字 可 以 声明 静态 类 成 员 ， 如 下 面 的 示例 
PTA : 


public class Automobile 


{ 
public static int NumberOfWheels = 4; 
public static int SizeOfGasTank 


{ 
get 


{ 
} 


public static void Drive() { } 
public static event EventType RunOutOfGas; 


return 15; 


// Other non-static fields and properties... 


静态 成 员 在 第 一 次 被 访问 之 前 并 且 在 调用 静态 构造 男 J (如 有 存在 ) 之 前 进行 初始 
类 成 员 ， 应 使 用 类 名 而 不 是 变量 名 来 指定 该 成 员 的 位 置 ， 如 下 面 
示例 所 示 : 


Automobile.Drive(); 
int i - Automobile.NumberOfWheels; 


MRAEABSRALER, dbtégUEDDA SE wpubix ESF RMA MDSESAG 
对 静态 方法 的 调用 以 Microsoft Fig i£ & (MSIL) 生成 调用 指令 ， 而 对 实例 方法 的 调 


用 生成 callvirt 指令 ， 该 指令 还 检查 null 对 象 引用 。 但 是 ， 两 者 之 间 的 性 能 差异 在 
大 多 数 时 候 并 不 明显 。 


和 无 至 -H 
C# 32 Bal 
有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 
C# 编程 指南 
static (C# 参考 ) 


类 (C# 编程 指南 ) 
class (C£ 参考 ) 
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af Sie (CH 编程 指南 ) 
实例 构造 画 数 (CH 编程 指南 ) 


静态 类 和 静态 类 成 员 (CH 编程 指南 ) 


95 


成 员 (C# 编程 指南 ) 


类 和 结构 具有 表示 其 数据 和 行为 的 成 员 。 类 的 成 员 包 插 在 类 中 声明 的 所 有 成 员 ， 以 
及 在 该 类 的 继承 层次 结构 中 的 所 有 类 中 声明 的 所 有 成 员 《构造 画 数 和 析 构 函数 除 
I) 。 基 类 中 的 私有 成 员 被 继承 ， 但 不 能 从 派生 类 访问 。 


下 表 列 出 类 或 结构 中 可 包含 的 成 员 类 型 : 


字段 
(CK 
编程 指 
南 ) 
常量 
(C# 
编程 指 
南 ) 
属性 
(C# 
编程 指 
南 ) 
司法 
(C#4 
编程 指 
南 ) 
事件 
(CH 
编程 指 
南 ) 
运算 符 
(C# 
编程 指 
南 ) 
索引 器 
(C# 
编程 指 
南 ) 
M3 ER 
Br (C£ 
编程 指 
南 ) 
析 构 图 
数 (CH 
编程 指 
南 ) 
BERGE 
型 (CH 
编程 指 
南 ) 


字段 是 在 类 范围 声明 的 变量 。 字 段 可 以 是 内 置 数值 类 型 或 其 他 类 的 实 
例 。 例 如 ， 日 历 类 可 能 具有 一 个 包含 当前 日 期 的 字段 。 


常量 是 在 编译 时 设置 其 值 并 且 不 能 更 改 其 值 的 字段 或 属性 。 


属性 是 类 中 可 以 像 类 中 的 字段 一 样 访问 的 方法 。 属 性 可 以 为 类 字段 提 
供 保护 ， 以 避免 字段 在 对 象 不 知道 的 情况 下 被 更 改 。 


方法 定义 类 可 以 执行 的 操作 。 方 法 可 以 接受 提供 输入 数据 的 参数 ， 并 
且 可 以 通过 参数 返回 输出 数据 。 方 法 还 可 以 不 使 用 参数 而 直接 返回 
值 。 


事件 向 其 他 对 象 提供 有 关 发 生 的 事情 (如 单 击 按钮 或 成 功 完成 某 个 方 
ik) 的 通知 。 事 件 是 使 用 委托 定义 和 触发 的 。 


BR ARAL A KM A o 在 重 载运 算 符 时 ， 在 类 中 将 该 运算 符 定 义 
为 公共 静态 方法 。 预 定义 运算 符 (+、*、< 等 ) 不 考虑 作为 成 员 。 有 
st 请 参阅 可 重 载运 算 符 (C# 编程 指南 ) o 


使 用 索引 器 可 以 用 类 似 于 数组 的 方式 为 对 象 建立 索引 。 


构造 画 数 是 在 第 一 次 创建 对 象 时 调用 的 方法 。 它 们 通常 用 于 初始 化 对 
象 的 数据 。 


CH rp se Far AEN. AER deb Eu dl 
运行 时 执行 引擎 调用 的 方法 。 它 们 通常 用 来 确保 任何 必须 释放 的 资 
都 得 到 适当 的 处理 。 


启 套 类 型 是 在 其 他 类 型 中 声明 的 类 型 ， 通 常用 于 描述 仅 由 包含 它们 的 
类 型 所 使 用 的 对 象 。 
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请 参阅 

C# 编程 指南 

类 (CH 编程 指南 ) 

方法 (CH 编程 指南 ) 
iS (CH 编程 指南 ) 
OR (CH 编程 指南 ) 
属性 (CH 编程 指南 ) 
字段 (CH 编程 指南 ) 
索引 器 (CH 编程 指南 ) 
事件 (CH 编程 指南 ) 
REZE (CH 编程 指南 ) 
运算 符 (CH 编程 指南 ) 
可 重 载运 算 符 (CH 编程 指南 ) 


成 员 (C# 编程 指南 ) 
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访问 修饰 符 (CH 编程 指南 ) 


所 有 类 型 和 类 型 成 员 都 具有 可 访问 性 级 别 ， 用 来 控制 是 否 可 以 在 您 程序 集 的 其 他 代 
码 中 或 其 他 程序 集中 使 用 它们 。 可 使 用 一 下 访问 修饰 符 指定 声明 类 型 或 成 员 时 类 型 
或 成 员 的 可 访问 性 。 

public 


同一 程序 集中 的 任何 其 他 代码 或 引用 该 程序 集 的 其 他 程序 集 都 可 以 访问 该 类 型 或 成 


Wo 

private 

只 有 同一 类 或 结构 中 的 代码 可 以 访问 该 类 型 或 成 员 。 
protected 


只 有 同一 类 或 结构 或 者 此 类 的 派生 类 中 的 代码 才 可 以 访问 的 类 型 或 成 员 。 
internal 


同一 程序 集中 的 任何 代码 都 可 以 访问 该 类 型 或 成 员 ， 但 其 他 程序 集中 的 代码 不 可 
以 。 


protected internal 

由 其 声明 的 程序 集 或 另 一 个 程序 集 派生 的 类 中 任何 代码 都 可 访问 的 类 型 或 成 员 。 从 
另 一 个 程序 集 进 行 访问 必须 在 类 声明 中 发 生 ， 该 类 声明 派生 自 其 中 声明 受 保护 的 内 
部 元 素 的 类 ， 并 且 必 须 通 过 派生 的 类 类 型 的 实例 发 生 。 

下 面 的 示例 演示 如 何 为 类 型 和 成 员 指定 访问 修饰 符 : 


public class Bicycle 


public void Pedal() { } 


不 是 所 有 访问 修饰 符 都 可 以 在 所 有 上 下 文中 由 所 有 类 型 或 成 员 使 用 ， 在 某 些 情况 下 
类 型 成 员 的 可 访问 性 受到 其 包含 类 型 的 可 访问 性 的 限制 。 以 下 各 节 提 供 了 有 关 可 访 
问 性 的 更 多 详细 信息 。 


类 和 结构 的 可 访问 性 


直接 在 命名 空间 中 声明 的 类 和 结构 〈 即 ， 没 有 艇 套 在 其 他 类 或 结构 中 的 类 和 结构 ) 
可 以 是 公共 类 和 结构 ， 也 可 以 是 内 部 类 和 结构 。 如 果 不 指 定 访问 修饰 符 ， 则 默认 为 
internal。 


结构 成 员 ， 包 括 馈 套 的 类 和 结构 ， 可 以 声明 为 公共 的 、 内 部 的 ， 或 私人 的 。 类 成 员 
(包括 柑 套 的 类 和 结构 ) 可 以 为 公共 的 、 受 保护 的 内 部 、 受 保护 的 、 内 部 的 或 私有 
的 。 类 成 员 和 结构 成 员 的 访问 级 别 ， 包 括 伐 套 类 和 结构 ， 默 认为 私有 。 不 可 以 从 包 
BRA ZH is BEER, 


派生 类 的 可 访问 性 不 能 高 于 其 基 类 型 。 换 名 话说， 不 能 有 从 内 部 类 A 派生 的 公共 类 
B。 如 果 人 允许 这 种 情况 ， 将 会 使 人 A 成 为 公共 类 ， 因 为 A 的 所 有 受 保护 的 成 员 或 内 部 
成 员 都 可 以 从 派生 类 访问 。 


可 以 使 用 InternalsVisibleToAttribute 使 其 他 某 些 程序 集 能 够 访问 您 的 内 部 类 型 。 有 
关 更 多 信息 ， 请 参见 友 元 程序 集 (C# 和 Visual Basic) o 


类 成 员 和 结构 成 员 的 可 访问 性 


可 以 使 用 五 种 访问 类 型 中 的 任何 一 种 来 声明 类 成 员 (包括 谋 套 的 类 和 结构 ) 。 结 构 
成 员 无 法 声明 为 受 保护 成 员 ， 因 为 结构 不 支持 继承 。 


通常 ， 成 员 的 可 访问 性 低 于 包含 成 员 的 类 型 的 可 访问 性 。 如 果 由 成 员 实现 接口 方法 
或 重 写 已 在 公共 基 类 中 定义 的 虚拟 方法 时 ， 内 部 类 的 公共 成 员 可 以 从 外 部 程序 集 访 
问 。 


任何 成 员 的 字段 、 属性 或 事件 的 类 型 必须 至 少 与 该 成 员 本 身 一 样 具 备 可 访问 性 。 同 
样 ， 作 为 方法 、 索 引 器 或 代表 的 任 一 成 员 的 返回 类 型 和 参数 类 型 必须 至 少 有 和 与 该 成 
员 本 身 一 样 的 可 访问 性 。 例 如 ， 如 果 C 不 是 公共 类 ， 则 不 能 返回 类 C 的 公共 方法 
M。 同 样 ， 如 果 A 声明 为 私有 ， 则 类 型 A 不 能 有 受 保护 的 属性 。 


用 户 定 义 的 运算 符 必 须 始终 声明 为 公共 运算 符 。 有 关 更 多 信息 ， 请 参见 运算 符 
(C# 参考 ) 。 
析 构 豆 数 不 能 具有 可 访问 性 修饰 符 。 


要 设置 类 成 员 或 结构 成 员 的 访问 级 别 ， 请 向 该 成 员 声 明 添 加 适当 的 关键 字 ， 如 下 面 
的 示例 所 示 。 


// public class: 
public class Tricycle 


// protected method: 
protected void Pedal() { } 


// private field: 
private int wheels - 3; 


// protected internal property: 
protected internal int Wheels 


( 


get ( return wheels; ) 


y 
Ef TER 


受 保护 内 部 可 访问 性 级 别 的 意思 是 受 保护 "或 "内 部 ， 而 不 是 受 保护 "和 "内 部 。 换 
句 话 说， 可 以 从 同一 程序 集 内 的 任何 类 (包括 派生 类 ) 中 访问 受 保护 的 内 部 成 
员 。 若 要 限制 为 只 有 同一 程序 集 内 的 派生 类 可 以 访问 ， 请 将 类 本 身 声 明 为 内 
部 ， 并 将 其 成 员 声 明 为 受 保护 。 


其 他 类 型 


直接 用 命名 空间 声明 时 ， 可 以 将 接口 声明 为 公共 接口 或 内 部 接口 ， 只 与 类 和 结构 一 
样 ， 接 口 默认 具有 内 部 可 访问 性 。 接 口 成 员 始 终 是 公共 成 员 ， 因 为 接口 的 用 途 是 让 
其 他 类 型 能 够 访问 某 个 类 或 结构 。 访 问 修饰 符 不 能 应 用 于 接口 成 员 。 


枚 举 成 员 始 终 是 公共 的 ， 不 能 应 用 任何 访问 修饰 符 。 


委托 行为 类 似 于 类 和 结构 。 默 认 情 况 下 ， 它 们 在 命名 空间 中 直接 声明 时 具有 内 部 访 
"x, FEN SAMA P5. 


CH 32 BASE 


有 关 详 细 信 息 ， 请 参阅 CH 话 言 规范 。 规范 是 CH 语法 和 用 法 的 权威 资料 。 


cat 
- 
N 
di 
ili 


请 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 
接口 (CH 编程 指南 ) 
private (C# 参考 ) 
public (C£ 参考 ) 
internal (C£ 参考 ) 
protected (C# 参考 ) 
class (C£ 参考 ) 
struct (C£ 参考 ) 
接口 (CH 参考 ) 


字段 (CH 编程 指南 ) 
字段 "是 直接 在 类 或 结构 中 声明 的 任何 类 型 的 变量 。 字 段 是 其 包含 类 型 的 “成员” 


类 或 结构 可 以 拥有 实例 字段 或 静态 字段 ， 或 同时 拥有 两 者 。 实 例 字段 特定 于 类 型 的 
实例 。 如 果 您 拥有 类 T 和 实例 字段 F， 可 以 创建 类 型 T 的 两 个 对 象 ， 并 修改 每 个 对 
象 中 F 的 值 ， 这 不 影响 另 一 对 象 中 的 该 值 。 相 比 之 下 ， 静 态 字 段 属 于 类 本 身 ， 在 该 
类 的 所 有 实例 中 共享 。 从 实例 A 所 做 的 更 改 将 立刻 呈现 在 实例 B 和 C 上 (如 果 它 
们 访问 该 字段 ) 。 


通常 应 仅 为 具有 私有 或 受 保护 可 访问 性 的 变量 使 用 字段 。 您 的 类 Pe ee g 
的 数据 应 通过 方法 、 属 性 和 索引 器 提供 。 通 过 使 用 这 些 构造 间接 访问 内 部 字段 ， 可 

以 针对 先 效 的 输入 秆 提供 防护 ， 存 供 由 公共 属性 公开 的 吏 据 的 私有 字 耻 称 为 " 尼 各 存 
储 "或 “支持 字段 ”。 


字段 通常 存储 这 样 的 数据 : 该 数据 必须 可 供 多 个 类 法 访问 ， 并 且 其 存储 期 必须 长 
于 任何 单个 方法 的 生存 期 。 例 如 ， 表 示 日 历 日 期 的 类 可 能 有 三 个 整数 字段 : 一 个 表 
示 月 份 ， 一 个 表示 日 期 ， 还 有 一 个 表示 年 份 。 不 在 单个 方法 范围 外 部 使 用 的 变量 应 
在 方法 体 自身 范围 内 声明 为 局 部 变量 。 


在 类 块 中 通过 指定 字段 的 访问 级 别 ， 然 后 指定 字段 的 类 型 ， 再 指定 字段 的 名 称 来 声 
明 这 这 些 字 字段。 例 如 : 


public class CalendarEntry 


// private field 
private DateTime date; 


// public field (Generally not recommended.) 
public string day; 


// Public property exposes date field safely. 
public DateTime Date 


{ 
get 


{ 
j 


set 


return date; 


// Set some reasonable boundaries for likely birth date 
if (value.Year > 1900 && value.Year <= DateTime.Today." 


date - value; 


else 
throw new ArgumentOutOfRangeException(); 


j 


// Public method also exposes date field safely. 
// Example call: birthday.SetDate("1975, 6, 30"); 
public void SetDate(string dateString) 

{ 


DateTime dt = Convert.ToDateTime(dateString); 


// Set some reasonable boundaries for likely birth dates. 
if (dt.Year > 1900 && dt.Year <= DateTime.Today.Year) 
{ 


} 


else 
throw new ArgumentOutOfRangeException(); 


date - dt; 


j 


public TimeSpan GetTimeSpan(string dateString) 
{ 


DateTime dt = Convert.ToDateTime(dateString); 


if (dt != null && dt.Ticks < date.Ticks) 
{ 


} 


else 
throw new ArgumentOutOfRangeException(); 


return date - dt; 





若 要 访问 对 象 中 的 字段 ， 请 在 对 象 名 称 后 面 添加 一 个 句点 ， 然 后 添加 该 字段 的 名 
称 ， 比 如 objectname.fieldname。 例 如 : 


CalendarEntry birthday = new CalendarEntry(); 
birthday.day = "Saturday"; 


声明 字段 时 可 以 使 用 赋值 运算 符 为 字段 指定 一 个 初始 值 。 例 如 ， 若 要 自动 将 
"Monday" 赋 给 day 字段 ， 需 要 声明 day， 如 下 例 所 示 : 


public class CalendarDateWithInitialization 
1 

public string day - "Monday"; 

OA 


FRAIL A SEAR COI AS EZ BU. MRA ENAA FEMA, WW 
值 将 覆盖 字段 声明 期 间 给 出 的 任何 值 。 有 关 更 多 信息 ， 请 参见 HAMS (CH 
编程 指南 ) 。 

区 注意 

字段 初始 值 设 定 项 不 能 引用 其 他 实例 字段 。 
字段 可 标记 为 public, private, protected, internal 或 protected internal。 这 些 访 
问 修 饰 符 定义 类 的 使 用 者 访问 字段 的 方式 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 
(CH 编程 指南 ) o 


可 以 选择 将 字段 声明 为 static。 这 使 得 调用 方 在 任何 时 候 都 能 使 用 字段 ， 即 使 类 没 
有 任何 实例 。 有 关 更 多 信息 ， 请 参见 静态 类 和 静态 类 成 员 (CH 编程 指南 ) o 


可 以 将 字段 声明 为 readonly。 只 读 字段 只 能 在 初始 化 期 间或 在 构造 本 数 中 赋值 。 
static readonly 字段 非常 类 似 于 常数 ， 只 不 过 C# 编译 器 不 能 在 编译 时 访问 静态 只 
读 字 段 的 值 ， 而 只 能 在 运行 时 访问 。 有 关 更 多 信息 ， 请 参见 常量 (CH 编程 指 

南 ) 。 

Ci 语言 规范 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
请 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 

使 用 构造 画 数 (CH 编程 指南 ) 

继承 (CH 编程 指南 ) 

访问 修饰 符 (CH 编程 指南 ) 

抽象 类 、 密 封 类 及 类 成 员 (C# 编程 指南 ) 


常量 (CH 编程 指南 ) 


常量 是 在 编译 时 已 知 并 在 程序 的 生存 期 内 不 发 生 更 改 的 不 可 变 值 。 常 量 使 用 const 
修饰 符 进 行 声 明 。 只 有 C# 内 置 类 型 (System.Object 除外 ) 可 以 声明 为 const. 
有 关内 置 类 型 的 列表 ， 请 参见 内 置 类 型 表 (C# 参考 ) 。 用 户 定义 的 类 型 (包括 
类 、 结 构 和 数组 ) 不 能 为 const。 请 使 用 readonly 修饰 符 创 建 在 运行 时 初始 化 一 次 
即 不 可 再 更 改 的 类 、 结 构 或 数组 。 


C# 不 支持 const 方法 、 属 性 或 事件 。 


可 以 使 用 枚 举 类 型 为 整数 内 置 类 型 (例如 int, uint, long 等 等 ) 定义 命名 常量 。 
有 关 更 多 信息 ， 请 参见 enum (C£ 参考 ) 。 


常量 必须 在 声明 时 初始 化 。 例 如 : 


class Calendari 


public const int months - 12; 


在 此 示例 中 ， 常 量 months 始终 为 12， 不 可 更 改 ， 即 使 是 该 类 自身 也 不 能 更 改 它 。 
实际 上 ， 当 编译 器 遇 到 C# 源 代码 (例如 months) 中 的 常量 修饰 符 时 ， 将 直接 把 文 
本 值 蔡 换 到 它 生成 的 中 间 语 言 IL) 代码 中 。 因 为 在 运行 时 没有 和 与 常量 关联 的 变量 地 
址 ， 所 以 const 字段 不 能 通过 引用 传递 ， 并 且 不 能 在 表达 式 中 作为 左 值 出 现 。 

8 注意 


当 引 用 在 其 他 代码 如 DLL 中 定义 的 常量 值 时 应 十 分 着 愤 。 如 果 新 版 本 的 DLL 为 
PIU 程序 仍 将 保留 旧 的 文本 值 ， 直 到 针对 新 版 本 重新 编译 程 
Fo 


可 以 同时 声明 多 个 相同 类 型 的 常量 ， 例 如 : 
class Calendar2 


const int months - 12, weeks - 52, days - 365; 


如 果 不 会 造成 循环 引用 ， 用 于 初始 化 一 个 常量 的 表达 式 可 以 引用 另 一 个 常量 。 例 
如 : 


class Calendar3 


{ 
const int months = 12; 
const int weeks = 52; 
const int days = 365; 
const double daysPerWeek = (double) days / (double) weeks; 
const double daysPerMonth = (double) days / (double) months; 
} 


常量 可 标记 为 public. private, protected, internal 或 protected**internal**, ix 4 

访问 修饰 符 定义 类 的 用 户 访问 该 常量 的 方式 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 
(CH 编程 指南 ) o 

因为 常量 值 对 该 类 型 的 所 有 实例 是 相同 的 ， 所 以 常量 被 当 作 static 字段 一 样 访问 。 

不 使 用 static 关键 字 声 明 常量 。 未 包含 在 定义 常量 的 类 中 的 表达 式 必须 使 用 类 名 、 

一 个 句点 和 常量 名 来 访问 该 常量 。 例 如 : 


int birthstones = Calendar.months; 


Rom A 
CH 语言 规 ; 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规 沁 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 
属性 (C# 编程 指南 ) 
类 型 (C# 编程 指南 ) 
readonly (C# 参考 ) 


Immutability in C# Part One: Kinds of Immutability (C# 中 的 不 变性 第 一 部 分 : 不 
变性 的 种 类 ) 


属性 (CH 编程 指南 ) 


属性 是 一 种 成 员 ， 它 提供 灵活 的 机 制 来 读 取 、 写 入 或 计算 私有 字段 的 值 。 属 性 可 用 
作 公 共 数 据 成 员 ， 但 它们 实际 上 是 称 为 访问 器 "的 特殊 方法 。 这 使 得 可 以 轻松 访问 
数据 ， 还 有 助 于 提高 方法 的 安全 性 和 灵活 性 。 

在 此 示例 中 ，TimePeriod 类 存储 时 间 段 。 该 类 在 内 部 以 秒 为 单位 存储 时 间 ， 但 是 名 
为 Hours 的 属性 允许 客户 端 以 小 时 为 单位 指定 时 间 。 Hours 属性 的 访问 器 执行 小 
时 与 秒 之 间 的 转换 。 


class TimePeriod 


{ 
private double seconds; 
public double Hours 
{ 
get { return seconds / 3600; } 
set { seconds = value * 3600; } 
} 
} 
class Program 
1 
static void Main() 
{ 
TimePeriod t = new TimePeriod(); 
// Assigning the Hours property causes the 'set' accessor 1 
t.Hours - 24; 
// Evaluating the Hours property causes the 'get' accessor 
System.Console.WriteLine("Time in hours: " + t.Hours); 
} 
} 


// Output: Time in hours: 24 





直接 只 返回 表达 式 结果 的 属性 很 常见 。 下 面 的 语法 快捷 方式 使 用 => 来 定义 这 些 属 


public string Name => First + " " + Last; 


属性 必须 为 只 读 ， 并 且 你 不 能 使 用 get 访问 器 关键 字 。 


属性 概述 
e 属性 允许 关公 开 获 取 和 设置 值 的 公共 方法 ， 而 隐藏 实现 或 验证 代码 。 


e get 属性 访问 器 用 于 返回 属性 值 ， 而 set 访问 器 用 于 分 配 新 值 。 这 些 访问 器 可 
ECC LPS 有 关 详 细 信 息 ， 请 参阅 限制 访问 器 可 访问 性 (CH 
程 指 BARA 


value 关键 字 用 于 定义 由 set 访问 器 分 配 的 值 。 
不 实现 set 访问 器 的 属性 均 为 只 读 。 


对 于 不 需要 任何 自 定 义 访 问 器 代码 的 简单 属性 ， 请 考虑 选择 使 用 自动 实现 的 属 
性 的 选项 。 有 关 详 细 信 息 ， 请 参 阅 上 自动 实现 的 属 性 (CH 编程 指南 ) o 


相关 章节 


e 使 用 属性 (C# 编程 指南 ) 

e 接口 属性 (C# 编程 指南 ) 

e 属性 和 索引 器 之 间 的 比较 (CH 编程 指南 ) 
e 限制 访问 器 可 访问 性 (CH 编程 指南 ) 

e 自动 实现 的 属性 (CH 编程 指南 ) 


CH 72 SHWE 

有 关 详 细 信 息 ， 请 参阅 C# 话 言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
请 参 阅 

C 编程 指南 


使 用 属性 (CH 编程 指南 ) 
索引 器 (CH 编程 指南 ) 


方法 (CH 编程 指南 ) 


方法 是 包含 一 系列 语句 的 代码 块 。 程 序 通过 调用 该 方法 并 指定 任何 所 需 的 方法 参数 
使 语句 得 以 执行 。 在 C# 中 ， 每 个 执行 的 指 倒 均 在 方法 的 上 下 文中 执行 。Main 方法 
是 每 个 C# 应 用 程序 的 人口 点 ， 并 在 启动 程序 时 由 公共 语言 运行 时 (CLR) 调用 。 

8 注意 


本 主题 讨论 命名 的 方法 。 有 关 匿 名 辑 数 的 信息 ， 请 参阅 匿名 函数 (CH 编程 指 
FA) o 


方法 签名 

通过 指定 访问 级 别 (如 public 或 private) 、 可 选修 饰 符 (如 abstract 或 
sealed) 、 返 回 值 、 方 法 的 名 称 以 及 任何 方法 参数 ， 在 类 或 结构 中 声明 方法 。 这 些 
部 件 一 起 构成 方法 的 签名 。 

8 注意 


出 于 方法 重 载 的 目的 ， 方 法 的 返回 类 型 不 是 方法 签名 的 一 部 分 。 但 是 在 确定 委 
托 和 它 所 指向 的 方法 之 间 的 兼容 性 时 ， 它 是 方法 签名 的 一 部 分 。 


方法 参数 在 括号 内 ， 并 且 用 逗号 分 隔 。 空 括号 指示 方法 不 需要 任何 参数 。 此 类 包含 
三 种 方法 : 


abstract class Motorcycle 


{ 
// Anyone can call this. 
public void StartEngine() (/* Method statements here */ } 
// Only derived classes can call this. 
protected void AddGas(int gallons) ( /* Method statements here 
// Derived classes can override the base class implementation. 
public virtual int Drive(int miles, int speed) ( /* Method stat 
// Derived classes must implement this. 
public abstract double GetTopSpeed(); 

} 


E — : 


方法 访问 





调用 对 象 上 的 方法 就 像 访问 字段 。 在 对 象 名 之 后 添加 一 个 句点 、 方 法 名 和 括号 。 参 
数列 在 括号 里 ， 并 且 用 到 号 分 隔 。 因 此 ， 可 在 以 下 示例 中 调用 Motorcycle 类 的 方 
法 : 


class TestMotorcycle : Motorcycle 


{ 
public override double GetTopSpeed() 
{ 
return 108.4; 
} 
static void Main() 
{ 
TestMotorcycle moto = new TestMotorcycle(); 
moto.StartEngine(); 
moto.AddGas(15); 
moto.Drive(5, 20); 
double speed - moto.GetTopSpeed(); 
Console.WriteLine("My top speed is {0}", speed); 
} 
} 


b eH 


方法 参数 与 参数 


该 方法 定义 指定 任何 所 需 参 数 的 名 称 和 类 型 。 调 用 代码 调用 该 方法 时 ， 它 为 每 个 参 
数 提供 了 称 为 参数 的 具体 值 。 参 数 必须 与 参数 类 型 兼容 ， 但 调用 代码 中 使 用 的 参数 
名 WARS) 不 需要 与 方法 中 定义 的 参数 名 相同 。 例 如 : 


public void Caller() 
i 


int numA - 4; 
// Call with an int variable. 
int productA - Square(numA); 


int numB - 32; 
// Call with another int variable. 
int productB - Square(numB); 


// Call with an integer literal. 
int productC - Square(12); 


// Call with an expression that evaulates to int. 
productC - Square(productA * 3); 
} 


int Square(int i) 

{ 
// Store input argument in a local variable. 
int input = i; 
return input * input; 


按 引 用 传递 与 按 值 传递 


默认 情况 下 ， 值 类 型 传递 给 方法 时 ， 传 递 的 是 副本 而 不 是 对 象 本 身 。 因 此 ， 对 参数 
的 更 改 不 会 影响 调用 方法 中 的 原始 副本 。 可 以 使 用 ref 关键 字 按 引用 传递 值 类 型 。 
有 关 详 细 信 息 ， 请 参阅 传递 值 类 型 参数 (CH 编程 指南 ) 。 有 关内 置 值 类 型 的 列 
表 ， 请 参阅 值 类 型 表 (CH 参考 ) 。 


引用 类 型 的 对 象 传递 到 方法 中 时 ， 将 传递 对 对 象 的 引用 。 也 就 是 说 ， 该 方法 接收 的 
不 是 对 象 本 身 ， 而 是 指示 该 对 象 位 置 的 参数 。 如 果 通 过 使 用 此 引用 更 改 对 象 的 成 
员 ， 即 使 是 按 值 传递 该 对 象 ， 此 更 改 也 会 反映 在 调用 方法 的 参数 中 。 
通过 使 用 class 关键 字 创 建 引用 类 型 ， 如 以 下 示例 所 示 。 

public class SampleRefType 

{ 


} 


public int value; 


现在 ， 如 果 将 基于 此 类 型 的 对 象 传递 到 方法 ， 则 将 传递 对 对 象 的 引用 。 下 面 的 示例 
将 SampleRefType 类 型 的 对 象 传递 到 ModifyObject 方法 。 


public static void TestRefType() 


SampleRefType rt - new SampleRefType(); 
rt.value - 44; 

ModifyObject(rt); 
Console.WriteLine(rt.value); 


} 
static void ModifyObject(SampleRefType obj) 
{ 
obj.value = 33; 
} 


该 示例 执行 的 内 容 实质 上 与 先前 示例 相同 ， 均 按 值 将 参数 传递 到 方法 。 但 是 因为 使 
用 了 引用 类 型 ， 结 果 有 所 不 同 。 ModifyObject 中 所 做 的 对 形 参 obj 的 value 字段 的 
修改 ， 也 会 更 改 TestRefType 方法 中 实 参 rt 的 value 字段 。 TestRefType 方法 显示 
33 作为 输出 。 


有 关 如 何 按 引用 和 按 值 传递 引用 类 型 的 详细 信息 ， 请 参阅 传递 引用 类 型 参数 (CH 
编程 指南 ) 和 引用 类 型 (CH 参考 ) 。 


RIE) f 


方法 可 以 将 值 返回 到 调用 方 。 如 果 列 在 方法 名 之 前 的 返回 类 型 不 是 void， 则 该 方法 
可 通过 使 用 return 关键 字 返 回 值 。 带 return 关键 字 ， 后 跟 和 与 返回 类 型 匹配 的 值 的 
语句 将 该 值 返回 到 方法 调用 方 。 return 关键 字 还 会 停止 执行 该 方法 。 如 果 返 回 类 
型 为 void， 没 有 值 的 return 语句 仍 可 用 于 停止 执行 该 方法 。 没 有 return 关键 字 ， 
当 方 法 到 达 代码 块 结尾 时 ， 将 停止 执行 。 具 有 非 空 的 返回 类 型 的 方法 都 需要 使 用 
return 关键 字 来 返回 值 。 例 如 ， 这 两 种 方法 都 使 用 return 关键 字 来 返回 整数 : 


class SimpleMath 


public int AddTwoNumbers(int numberi, int number2) 


{ 
} 


return number1 + number2; 


public int SquareANumber(int number) 


return number * number; 


若 要 使 用 从 方法 返回 的 值 ， 调 用 方法 可 以 在 相同 类 型 的 值 足够 的 地 方 使 用 该 方法 调 
用 本 身 。 也 可 以 将 返回 值 分 配给 变量 。 例 如 ， 以 下 两 个 代码 示例 实现 了 相同 的 目 


标 : 


int result - obj.AddTwoNumbers(1, 2); 
result - obj.SquareANumber(result); 
// The result is 9. 
Console.WriteLine(result); 


result = obj.SquareANumber(obj.AddTwoNumbers(1, 2)); 
// The result is 9. 
Console.WriteLine(result); 


在 这 种 情况 下 ， 使 用 本 地 变量 result 存储 值 是 可 选 的 。 此 步骤 可 以 帮助 提高 代码 的 
可 读 性 ， 或 者 如 果 需 要 存储 该 方法 整个 范围 内 参数 的 原始 值 ， 则 此 步骤 可 能 很 有 必 
要 。 


有 关 详 细 信息 ， 请 参阅 return (CH 参考 ) 。 


异步 方法 


通过 使 用 异步 功能 ， 你 可 以 调用 异步 方法 而 无 需 使 用 显 式 回调 ， 也 不 需要 跨 多 个 方 
法 或 lambda 表达 式 来 手动 拆 分 代码 。Visual Studio 2012 中 已 引入 异步 功能 。 


如 果 用 async 修饰 符 标 记 方 法 ， 则 可 以 使 用 该 方法 中 的 await 运算 符 。 当 控件 到 达 
异步 方法 中 的 await 表达 式 时 ， 控 件 将 返回 到 调用 方 ， 并 在 等 待 任务 完成 前 ， 方 法 
中 进度 将 一 直人 处 于 挂 起 状态 。 任 务 完 成 后 ， 可 以 在 方法 中 恢复 执行 。 


= 
Ef TE 


异步 方法 在 遇 到 第 一 个 尚未 完成 的 awaited 对 象 或 到 达 异 步 方法 的 末尾 时 (以 
先 发 生 者 为 准 ) ， 将 返回 到 调用 方 。 


异步 方法 可 以 具有 Task<TResult>、Task 或 void 返回 类 型 。Void 返回 类 型 主要 用 
于 定义 需要 void 返回 类 型 的 事件 处 理 程序 。 无 法 等 待 返回 void 的 异步 方法 ， 并 且 
返回 void 方法 的 调用 方 无 法 捕获 该 方法 引发 的 异常 。 


在 以 下 示例 中 ，DelayAsync 是 具有 Task<TResult> 返回 类 型 的 异步 方法 。 
DelayAsync 具有 返回 整数 的 return 语句 。 因 此 ，DelayAsync 的 方法 声明 必须 具 
有 Task<int> 的 返回 类 型 。 因 为 返回 类 型 是 Task<int>，DoSomethingAsync 中 
await 表达 式 的 计算 如 以 下 语句 所 示 得 出 整数 int result = await delayTask。 


startButton Click 方法 是 具有 void 返回 类 型 的 异步 方法 的 示例 。 因 为 
DoSomethingAsync 是 异步 方法 ， 调 用 DoSomethingAsync 的 任务 必须 等 待 ， 如 以 
下 语句 所 示 : await DoSomethingAsync();。 startButton Click 方法 必须 使 用 
async 修饰 符 进行 定义 ， 因 为 该 方法 具有 await 表达 式 。 


// using System.Diagnostics; 
// using System.Threading.Tasks; 


// This Click event is marked with the async modifier. 
private async void startButton Click(object sender, RoutedEventArg: 


{ 


await DoSomethingAsync(); 


} 
private async Task DoSomethingAsync() 
{ 
Task<int> delayTask = DelayAsync(); 
int result = await delayTask; 
// The previous two statements may be combined into 
// the following statement. 
//int result = await DelayAsync(); 
Debug.WriteLine("Result: " + result); 
} 
private async Task<int> DelayAsync() 
{ 
await Task.Delay(100); 
return 5; 
} 
// Output: 


// Result: 5 





异步 方法 不 能 声明 任何 ref 或 out 参数 ， 但 是 可 以 调用 具有 这 类 参数 的 方法 。 
有 关 异 步 方 法 的 详细 信息 ， 请 参阅 使 用 Async 和 Await 的 异步 编程 (C# 和 Visual 


Basic) 、 异 步 程 序 中 的 控制 流 (C# 和 Visual Basic) 和 异步 返回 类 型 (C£ 和 
Visual Basic) 。 


表达 式 主体 定义 


具有 立即 包 返 回 表 达 式 结果 ， 或 单个 语句 作为 方法 主题 的 方法 定义 很 常见 。 以 下 是 
使 用 => 定义 此 类 方法 的 语法 快捷 方式 : 


public Point Move(int dx, int dy) => new Point(x + dx, y + dy); 
public void Print() => Console.WriteLine(First + " " + Last); 

// Works with operators, properties, and indexers too. 

public static Complex operator +(Complex a, Complex b) => a.Add(b), 
public string Name => First + " " + Last; 

public Customer this[long id] -» store.LookupCustomer(id); 


id RE | 


如 果 该 方法 返回 void 或 是 异步 方法 ， 则 该 方法 的 主体 必须 是 语句 表达 式 (与 
lambda 相同 ) 。 对 于 属性 和 索引 器 ， 两 者 必须 是 只 读 ， 并 且 不 使 用 get 访问 器 关 
键 字 。 


Xi as 


ERB UREA AREER, MRR, SASHES yield return 语句 返回 
元 素 ， 每 次 返回 一 个 。 当 yield return 语句 到 达 时 ， 将 记 住 当前 在 代码 中 的 位 置 。 
下 次 调用 迭代 器 时 ， 将 从 该 位 置 重 新 开始 执行 。 

通过 使 用 foreach 语句 从 客户 端 代码 调用 迭代 器 。 


迭代 器 的 返回 类 型 可 以 是 IEnumerable、IEnumerable<T>、1IEnumerator 或 
IEnumerator<T>。 


有 关 详 细 信 息 ， 请 参阅 迭代 器 (C# 和 Visual Basic) 。 





+ 


CH j2 BAS 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

CH 编程 指南 

类 和 结构 (CH 编程 指南 ) 

访问 修饰 符 (CH 编程 指南 ) 
静态 类 和 静态 类 成 员 (CH 编程 指南 ) 
继承 (CH 编程 指南 ) 

抽象 类、 密封 类 及 类 成 员 (CH 编程 指南 ) 
params (C# 参考 ) 

return (C# 参考 ) 
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ref (CH BS) 
传递 参数 (CH 编程 指南 ) 


方法 (CH 编程 指南 ) 
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MERZ (CH 编程 指南 ) 


任何 时 候 ， 只 要 创建 类 或 2 吉 构 ， 就 会 ACH wie RESA ža? 吉 构 可 和 有 EE 有 多 个 接受 
不 同 参 数 的 构造 罚 数 。 构 造 画 数 使 得 程序 员 可 设置 默认 值 、 限 制 实例 化 以 及 编写 灵 
活 且 便于 阅读 的 代码 。 有 关 更 多 信息 和 示例 ， 请 参见 使 用 构造 男 数 (CH 编程 指 
南 ) FNS PAIGE (CH 编程 指南 ) o 


如 果 您 没有 为 对 象 提供 构造 男 数 ， 则 默认 情况 下 C# 将 创建 一 个 构造 豆 数 ， 该 构造 
HAK DIESE RR, 并 将 成 员 变量 设置 为 默认 值 表 〈C# 参考 ) 中 列 出 的 默认 值 。 有 
关 更 多 信 A/D 息 和 示例 ， 请 参见 实例 构造 函数 (C4 编程 指南 ) 。 


静态 类 和 结构 也 可 以 有 构造 男 数 。 有 关 更 多 信息 和 示例 ， 请 人 参见 静态 构造 男 数 (CH 
编程 指南 ) o 


本 节 内 容 


(EFA AIEEE (CH 编程 指南 ) 
实例 构造 画 数 (CH 编程 指南 ) 
MB MSN (CH 编程 指南 ) 
at A Mie (CH 编程 指南 ) 
如 何 : 编写 复制 构造 图 数 (C# 编程 指南 ) 


请 


" 


阅 


C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 

ATA (CH 编程 指南 ) 

static (C# 参考 ) 

初始 值 设 定 项 原因 按 相反 顺序 运行 作为 构造 酌 数 ? Part One (第 一 部 分 ) 


析 构 函数 (CH 编程 指南 ) 

析 构 范 数 用 于 析 构 类 的 实例 。 

备注 

。 不 能 在 结构 中 定义 析 构 丽 数 。 只 能 对 关 使 用 析 构 函数 。 
。 一 个 类 只 能 有 一 个 析 构 函数 。 

。 无 法 继承 或 重 栽 析 构 函数 。 

无 法 调用 析 构 函数 。 它 们 是 被 自动 调用 的 。 


。 析 构 范 数 既 没有 修饰 符 ， 也 没有 参数 。 
例如 ， 下 面 是 类 Car 的 析 构 加 数 的 声明 : 


class Car 
~Car() // destructor 


// cleanup statements... 


IT AS ZA Shh x RAE KGB Finalize。 这 样 ， 前 面 的 析 构 画 数 代码 被 隐 式 
地 转换 为 以 下 代码 : 


protected override void Finalize() 
try 
// Cleanup statements... 
final 


base.Finalize(); 


这 意味 着 对 继承 链 中 的 所 有 实例 递归 地 调用 Finalize 方法 (从 派生 程度 最 大 的 到 派 
生 程 度 最 小 的 ) 。 


sate 
Uf ES 


A ERAT HH. MRK ASMA, Finalize 队列 中 则 会 创建 一 个 项 。 
调用 析 构 函数 时 ， 将 调用 垃圾 回收 器 来 处 理 该 队列 。 如 果 析 构 画 数 为 空 ， 只 会 
导致 不 必要 的 性 能 损失 。 


程序 员 无 法 控制 何 时 调用 析 构 汞 数 ， 因 为 这 是 由 垃圾 回收 器 决定 的 。 垃 圾 回收 器 检 
查 是 否 存在 应 用 程序 不 再 使 用 的 对 象 。 如 果 垃 圾 回收 器 认为 某 个 对 象 符合 析 构 ， 则 
J (如 果 有 ) 并 回收 用 来 存储 此 对 象 的 内 存 。 程 序 退 出 时 也 会 调用 析 构 
ER o 


Be Collect 强制 进行 垃圾 回收 ， 但 大 多 数 情 况 下 应 避免 这 样 做 ， 因 为 这 
会 导致 性 能 问题 。 


使 用 析 构 范 效 释放 资源 


通常 ， 与 运行 时 不 进行 垃圾 回收 的 开发 语言 相 比 ，C# 无 需 太 多 的 内 存 管理 。 这 是 
因为 .NET Framework 垃圾 回收 器 会 隐 陈 地 管理 对 象 的 闪存 分 配 和 释放 。 (Big, 4 
应 用 程序 封装 窗口 、 文 件 和 网 络 连接 这 类 非 托 管 资源 时 ， 应 当 使 用 析 构 函数 释放 这 
些 资源 。 当 对 象 符合 析 构 时 ， 过 级 回收 器 将 运行 对 象 的 Finalize 方法 。 


资源 的 显 式 释放 


如 果 您 的 应 用 程序 在 使 用 昂贵 的 外 部 资源 ， 我 们 还 建议 您 提供 一 种 在 垃圾 回收 器 释 
放 对 象 前 显 式 地 释放 资 源 的 方式 可 通过 实现 来 自 IDisposable 接口 的 Dispose 方 
法 来 完成 这 一 点 ， 该 方法 为 对 象 执 行 必要 的 清理 。 这 样 可 大 大 提高 应 用 程序 的 性 
能 。 即 使 有 这 种 对 资源 的 显 式 控制 ， 析 构 函 数 也 是 一 种 保护 措施 ， 可 用 来 在 对 
Dispose 方法 的 调用 失败 时 清理 资源 。 


有 关 清 理 资 源 的 更 多 详细 信息 ， 请 参见 下 列 主题 : 
e Cleaning Up Unmanaged Resources 
e Implementing a Dispose Method 
e using 语句 (CH 参考 ) 


下 面 的 示例 创建 三 个 类 ， 这 三 个 类 构成 了 一 个 继承 链 。 类 First ZAK, Second = 
从 First 派生 的 ， 而 Third Second 派生 的 。 这 三 个 类 都 有 析 构 函数 。 在 Main() 
中 ， 创 建 了 派生 程度 最 大 的 类 的 实例 。 注 意 : 程序 运行 时 ， 这 三 个 类 的 析 构 函数 将 
自动 被 调用 ， 并 且 是 按照 从 派生 程度 最 大 的 到 派生 程度 最 小 的 次 序 调用 。 


BJE) 


class First 


{ 
~First() 
{ 
System.Diagnostics.Trace.WriteLine("First's destructor is « 
} 
} 
class Second : First 
-Second() 
{ 
System.Diagnostics.Trace.WriteLine("Second's destructor is 
} 
} 
class Third : Second 
~Third() 
{ 
System.Diagnostics.Trace.WriteLine("Third's destructor is « 
} 


} 


class TestDestructors 


( 


static void Main() 


Third t - new Third(); 


/* Output (to VS Output Window): 
Third's destructor is called. 
Second's destructor is called. 
First's destructor is called. 

27 





C# 语言 规范 
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Garbage Collection 
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对 象 和 集合 初始 值 设 定 项 (CH 编程 指责) 


使 用 对 象 初 始 值 设 定 项 ， 你 可 以 在 创建 对 象 时 向 对 象 的 任何 可 访问 字段 或 属性 分 配 
值 ， 而 无 需 调 用 后 跟 赋 值 语句 行 的 构造 本 数 。 利 用 对 象 初始 值 设 定 项 语法 ， 你 可 为 
构造 画 数 指定 参数 或 忽略 参数 〈 以 及 括号 语法 ) 。 以 下 示例 演示 如 何 使 用 具有 命名 
类 型 Cat 的 对 象 初 始 值 设 定 项 以 及 如 何 调用 默认 构造 画 数 。 请 注意 ， 自 动 实现 的 属 
性 在 Cat 类 中 的 用 法 。 有 关 详 细 信 息 ， 请 参阅 自动 实现 的 属性 (CH 编程 指南 ) o 


class Cat 


// Auto-implemented properties. 
public int Age ( get; set; } 
public string Name ( get; set; } 


Cat cat = new Cat ( Age = 10, Name = "Fluffy" Y; 


具有 匿名 类 型 的 对 象 初 始 值 设 定 项 


尽管 对 象 初始 值 设 定 项 可 用 于 任何 上 下 文中 ， 但 它们 在 LINQ 查询 表达 式 中 特别 有 
用 。 查 询 表达 式 常 使 用 只 能 通过 使 用 对 象 初始 值 设 定 项 进行 初始 化 的 匿名 类 型 ， 如 
下 面 的 声明 所 示 。 


var pet = new { Age = 10, Name = "Fluffy" }; 


利用 匿名 类 型 ，select 查询 表达 式 中 的 LINQ 子 句 可 以 将 原始 序列 的 对 象 转 换 为 其 
值 和 形状 可 能 不 同 于 原始 序列 的 对 象 。 如 果 你 只 想 存 储 某 个 序列 中 每 个 对 象 的 部 分 
信息 ， 则 这 很 有 用 。 在 下 面 的 示例 中 ， 假 定 产品 对 象 (p) 包含 很 多 字段 和 方法 ， 而 
你 只 想 创 建 包 含 产 品名 和 单价 的 对 象 序列 。 


var productInfos = 
from p in products 
select new ( p.ProductName, p.UnitPrice }; 


执行 此 查询 时 ，productlnfos 变量 将 包含 一 系列 对 象 ， 这 些 对 象 可 以 在 foreach jz 
句 中 进行 访问 ， 如 下 面 的 示例 所 示 : 


foreach(var p in productInfos)(...) 


新 的 匿名 类 型 中 的 每 个 对 象 都 具有 两 个 公共 属性 ， 这 两 个 属性 接收 与 原始 对 象 中 的 
属性 或 字段 相同 的 名 称 。 你 还 可 在 创建 匿名 类 型 时 重 命名 字段 ; 下 面 的 示例 将 
UnitPrice 字段 重 命名 为 Price。 


select new {p.ProductName, Price = p.UnitPrice}; 


具有 可 以 为 null 的 类 型 的 对 象 初始 值 设 定 项 


使 用 具有 可 以 为 null 的 结构 的 对 象 初始 值 设 定 项 会 导致 编译 时 错误 。 


SEG AG 8 i XE RR 


集合 初始 值 设 定 项 允许 在 初始 化 实现 IEnumerable 的 集合 类 或 初始 化 具有 Add 扩 
展 方法 的 类 时 ， 指 定 一 个 或 多 个 元 素 初 始 值 设 定 项 。 元 素 初 始 值 设 定 项 可 以 是 简单 
的 值 、 表 达 式 或 对 象 初始 值 设 定 项 。 通 过 使 用 集合 初始 值 设 定 项 ， 你 将 无 需 在 源 代 
码 中 指定 对 该 类 的 Add 方法 的 多 个 调用 ; 编译 器 将 添加 这 些 调用 。 


下 面 的 示例 演示 了 两 个 简单 的 集合 初始 值 设 定 项 : 
List<int> digits = new List<int> { O, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; 
List<int> digits2 = new List<int> { 0 + 1, 12 % 3, MakeInt() }; 
4 — BE 
下 面 的 集合 初始 值 设 定 项 使 用 对 象 初始 值 设 定 项 来 初始 化 上 一 个 示例 中 定义 的 Cat 
类 的 对 象 。 请 注意 ， 各 个 对 象 初始 值 设 定 项 分 别 括 在 大 括号 中 且 用 逗号 隔 开 。 


List<Cat> cats = new List<Cat> 


new Cat(){ Name = "Sylvester", Age=8 }, 

new Cat(){ Name = "Whiskers", Age=2 }, 
new Cat(){ Name = "Sasha", Age=14 } 

}; 


如 果 集 合 的 nul 方法 允许 ， 则 可 以 将 Add 指定 为 集合 初始 值 设 定 项 中 的 一 个 元 
List«Cat» moreCats = new List<Cat> 
new Cat(){ Name 


new Cat(){ Name 
null 


"Furrytail", Age-5 }, 
"Peaches", Age-4 }, 


HH 


如 果 集 合 支持 索引 ， 可 以 指定 索引 元 素 。 


var numbers = new Dictionary<int, 


[7] = "seven", 
[9] = "nine", 
[13] = "thirteen" 


) 


string» ( 


// The following code consolidates examples from the topic. 
class Objinitializers 
{ 
class Cat 
{ 
// Auto-implemented properties. 
public int Age { get; set; } 
public string Name { get; set; } 


} 
static void Main() 
{ 
Cat cat = new Cat { Age = 10, Name = "Fluffy" }; 
List<Cat> cats = new List<Cat> 
{ 
new Cat(){ Name = "Sylvester", Age=8 }, 
new Cat(){ Name = "Whiskers", Age=2 }, 
new Cat(){ Name = "Sasha", Age=14 } 
}; 
List<Cat> moreCats = new List<Cat> 
{ 
new Cat(){ Name = "Furrytail", Age=5 }, 
new Cat(){ Name = "Peaches", Age=4 }, 
null 
}; 
// Display results. 
System.Console.WriteLine(cat.Name); 
foreach (Cat c in cats) 
System.Console.WriteLine(c.Name); 
foreach (Cat c in moreCats) 
if (c !- null) 
System.Console.WriteLine(c.Name); 
else 
System.Console.WriteLine("List element has null va: 
// Output: 
//Fluffy 
//Sylvester 
/ /Whiskers 
//Sasha 
//Furrytail 
/ /Peaches 


//List element has null value. 
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如 何 : 使 用 foreach 访问 集合 类 (CH 编程 指南 ) 


下 面 的 代码 示例 演示 如 何 编 写 可 与 foreach 结合 使 用 的 非 泛 型 集合 类 。 该 示例 定义 
了 字符 串 tokenizer 类 。 


y 
Eg TE 


此 示例 描述 的 是 仅 当 您 无 法 使 用 泛 型 集合 aie ea 有 关 如 何 实 
现 支持 IEnumerable«T» 的 类 : 型 安全 的 泛 型 集合 类 类 ， 请 参见 迭代 器 (CH 和 
Visual Basic) 。 


在 该 示例 中 ， 以 下 代码 段 使 用 Tokens 3:38:31" "和 "“-” 分 隔 符 将 句子 “This is a sample 
sentence.” 分 成 若干 标记 。 该 代码 然后 使 用 foreach 话 句 显示 这 些 标记 。 


Tokens f = new Tokens("This is a sample sentence.", new char[] {' 


// Display the tokens. 
foreach (string item in f) 


1 


System.Console.WriteLine(item); 





在 内 部 ，Tokens 类 使 用 数组 存储 这 些 标记 。 因 为 数组 可 实现 IEnumerator 和 
IEnumerable， 所 以 代码 示例 使 用 了 数组 的 枚 举 方 法 
(GetEnumerator、MoveNext、Reset 和 Current) ， 而 不 是 在 Tokens 类 中 定义 
这 些 方 法 。 方 法 定义 包括 在 该 示例 中 ， 以 明确 如 何 定义 它们 以 及 每 个 定义 的 内 容 。 


using System.Collections; 


// Declare the Tokens class. The class implements the IEnumerable : 
public class Tokens : IEnumerable 


( 


private string[] elements; 
Tokens(string source, char[] delimiters) 


// The constructor parses the string argument into tokens. 
elements - source.Split(delimiters); 


j 


// The IEnumerable interface requires implementation of method 
public IEnumerator GetEnumerator() 


i 
} 


return new TokenEnumerator (this); 


// Declare an inner class that implements the IEnumerator intei 
private class TokenEnumerator : IEnumerator 


{ 
private int position = -1; 
private Tokens t; 


public TokenEnumerator(Tokens t) 


{ 
} 


this.t = t; 


// The IEnumerator interface requires a MoveNext method. 
public bool MoveNext() 


{ 


if (position < t.elements.Length - 1) 


position++; 
return true; 


} 


else 


{ 
} 


return false; 


} 


// The IEnumerator interface requires a Reset method. 
public void Reset() 


i 
} 


position = -1; 


// The IEnumerator interface requires a Current method. 
public object Current 


{ 
get 


{ 
} 


return t.elements[position]; 


} 


// Test the Tokens class. 
static void Main() 


( 


// Create a Tokens instance. 
Tokens f = new Tokens("This is a sample sentence.", new ch: 


// Display the tokens. 
foreach (string item in f) 


{ 
} 


System.Console.WriteLine(item); 


} 
/* Output: 
This 
is 
a 
sample 
sentence. 
ay 


«| m 








在 CH 中 ， 集 合 类 不 必 通 过 实现 IEnumerable 和 IEnumerator #4 foreach 兼容 。 
如 果 此 类 具有 所 需 的 GetEnumerator、MoveNext、Reset 和 Current 成 员 ， 则 可 与 
foreach 结合 使 用 。 省 略 接口 有 一 个 好 处 : 即 ， 您 可 以 比 Object 更 为 具体 地 定义 
Current 的 返回 类 型 。 这 会 提供 类 型 安全 。 


例如 ， 可 更 改 上 述 示例 中 的 以 下 行 。 


// Change the Tokens class so that it no longer implements IEnumer: 
public class Tokens 


{ 
Aus 
// Change the return type for the GetEnumerator method. 
public TokenEnumerator GetEnumerator( ) 
Ü 3 
// Change TokenEnumerator so that it no longer implements IEnur 
public class TokenEnumerator 
{ 
M r 
// Change the return type of method Current to string. 
public string Current 
Ü 3 
} 
} 





由 于 Current 返回 字符 串 ， 因 此 编译 器 能 够 检测 何 时 在 foreach aoh FH SAR 
容 的 类 型 ， 如 以 下 代码 所 示 。 


// Error: Cannot convert type string to int. 
foreach (int item in f) 


省 略 |Enumerable #0 IEnumerator 的 缺点 是 : 集合 类 不 再 与 其 他 公共 语言 运行 时 话 
BM foreach 语句 或 等 效 语句 交互 。 
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REXA! (CH 编程 指南 ) 
在 关 或 告 构 内 部 定义 的 类 型 称 为 赂 套 关 型 。 例 如 : 


class Container 
1 


class Nested 


Nested() ( ) 


不 管 外 部 类 型 是 类 还 是 结构 ， 刻 套 类 型 均 默 认为 private， 但 是 可 以 设置 为 public、 
protected internal, protected, internal 或 private。 在 上 面 的 示例 中 ，Nested 对 外 
部 类 型 是 不 可 访问 的 ， 但 可 以 设置 为 public， 如 下 所 示 : 


class Container 
public class Nested 


Nested() { } 


REE 《或 内 部 类 型 ) 可 访问 包含 类 型 (或 外 部 类 型 ) 。 若 要 访问 包含 类 型 ， 请 
将 其 作为 构造 画 数 传递 给 骸 套 类 型 。 例 如 : 


public class Container 


public class Nested 


{ 
private Container parent; 
public Nested() 
{ 
} 
public Nested(Container parent) 
{ 
this.parent = parent; 
} 
} 


BUE AHA ESSA. AAAA. CBE TA AMAR 
员 和 受 保护 成 员 《包括 所 有 继承 的 受 保护 成 员 ) 。 


在 前 面 的 声明 中 ， 类 Nested 的 完整 名 称 为 Container.Nested, x ARA SRE 
类 新 实例 的 名 称 ， 如 下 所 示 : 


Container.Nested nest = new Container.Nested(); 


请 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 
访问 修饰 符 (CH 编程 指南 ) 
构造 函数 (CH 编程 指南 ) 


分 部 类 和 方法 (CH 编程 指责) 


可 以 将 类 或 结构 、 接 口 或 方法 的 定义 拆 分 到 两 个 或 多 个 源 文 件 中 。 每 个 源 文件 包含 
类 型 或 方法 定义 的 一 部 分 ， 编 译 应 用 程序 时 将 把 所 有 部 分 组 合 起 来 。 


分 部 类 
在 以 下 几 种 情况 下 需要 拆 分 类 定义 : 


。 处 理 大 型 项 目 时 ， 使 一 个 类 分 布 于 多 个 独立 文件 中 可 以 让 多 位 程序 员 同 时 对 该 
类 进行 处 理 。 


使 用 自动 生成 的 源 时 ， 无 需 重 新 创建 源 文件 便 可 将 代码 添加 到 类 中 。Visual 
Studio 在 创建 Windows 窗 体 、Web 服务 包装 代码 等 时 都 使 用 此 方法 。 无 需 修 
改 Visual Studio 创建 的 文件 ， 就 可 创建 使 用 这 些 类 的 代码 。 


e 若 要 拆 分 类 定义 ， 请 使 用 partial 关键 字 修饰 符 ， 如 下 所 示 : 


public partial class Employee 
public void DoWork() 


} 
} 


public partial class Employee 


public void GoToLunch() 
{ 
} 


partial 关键 字 指示 可 在 命名 空间 中 定义 该 类 、 结 构 或 接口 的 其 他 部 分 。 所 有 部 分 都 
必须 使 用 partial 关键 字 。 在 编译 时 ， 各 个 部 分 都 必须 可 用 来 形成 最 终 的 类 型 。 各 
个 部 分 必须 具有 相同 的 可 访问 性 ， 如 public、private 等 。 


如 果 将 任意 部 分 声明 为 抽象 的 ， 则 整个 类 型 都 被 视 为 抽象 的 。 如 果 将 任意 部 分 声明 
为 密封 的 ， 则 整个 类 型 都 被 视 为 密封 的 。 如 果 任 意 部 分 声明 基 类 型 ， 则 整个 类 型 都 
将 继承 该 类 。 


指定 基 类 的 所 有 部 分 必须 一 致 ， 但 忽略 基 类 的 部 分 仍 继 承 该 基 类 型 。 各 个 部 分 可 以 
指定 不 同 的 基 接口 ， 最 终 类 型 将 实现 所 有 分 部 声明 所 列 出 的 全 部 接口 。 在 某 一 分 部 
定义 中 声明 的 任何 类 、 结 构 或 接口 成 员 可 供 所 有 其 他 部 分 使 用 。 最 终 类 型 是 所 有 部 
分 在 编译 时 的 组 合 。 


WIE 
partial 修饰 符 不 可 用 于 委托 或 枚 举 声 明 中 。 


TU PROS 型 可 以 是 分 部 的 ， 即 使 它们 所 启 套 于 的 类 型 本 身 并 不 是 分 部 
也 如 此 。 


class Container 


t 
partial class Nested 
d 
void Test() { } 
partial class Nested 
{ 
void Test2() { } 
} 
} 


编译 时 将 对 分 部 类 型 定义 的 特性 进行 合并 。 例 如 ， 请 考虑 下 列 声明 : 
[SerializableAttribute] 


partial class Moon { } 


[ObsoleteAttribute] 
partial class Moon { } 


它们 等 效 于 以 下 声明 : 


[SerializableAttribute] 
[ObsoleteAttribute] 
class Moon { } 


将 从 所 有 分 部 类 型 定义 中 对 以 下 内 容 进行 合并 : 
e XML 注释 
。 接口 
e 泛 型 类 型 参数 特性 
e 类 特性 
e members 


例如 ， 请 考虑 下 列 声明 : 


partial class Earth : Planet, IRotate ( } 
partial class Earth : IRevolve ( } 


它们 等 效 于 以 下 声明 : 


class Earth : Planet, IRotate, IRevolve ( } 


限制 

处 理 分 部 类 定义 时 需 尊 循 下 面 的 几 个 规则 : 

。 要 作为 同一 类 型 的 各 个 部 分 的 所 有 分 部 类 型 定义 都 必须 使 用 partial 进行 修 
人 饰 。 例 如 ， 下 面 的 类 声明 将 生成 错误 : 


public partial class A { } 
//public class A { } // Error, must also be marked partial 


partial 修饰 符 只 能 出 现在 紧 靠 关键 字 class, struct 或 interface 前 面 的 位 
iB. 


e 分 部 类 型 定义 中 允许 使 用 谋 套 的 分 部 类 型 ， 如 下 面 的 示例 中 所 示 : 


partial class ClassWithNestedClass 


{ 
} 


partial class ClassWithNestedClass 


partial class NestedClass { } 


partial class NestedClass { } 


e 要 成 为 同一 类 型 的 各 个 部 分 的 所 有 分 部 类 型 定义 都 必须 在 同一 程序 集 和 同一 模 
3& (exe 或 dil 文件 ) 中 进行 定义 。 分 部 定义 不 能 跨越 多 个 模块 。 


e 类 名 和 泛 型 类 型 参数 在 所 有 的 分 部 类 型 定义 中 都 必须 匹配 。 泛 型 类 型 可 以 是 分 
部 的 。 每 个 分 部 声明 都 必须 以 相同 的 顺序 使 用 相同 的 参数 名 。 

e 下 面 的 用 于 分 部 类 型 定义 中 的 关键 字 是 可 选 的 ， 但 是 如 果 某 关键 字 出 现在 一 个 
分 部 类 型 定义 中 ， 则 该 关键 字 不 能 与 在 同一 类 型 的 其 他 分 部 定义 中 指定 的 关键 
字 冲 突 : 

o public 


o private 


o protected 
o internal 
o abstract 
o sealed 
o 基 类 
o new £g E (RERI) 
o 泛 型 约束 
有 关 更 多 信息 ， 请 参见 类 型 参数 的 约束 (CH 编程 指南 ) o 


示例 1 
说 明 
下 面 的 示例 在 一 个 分 部 类 定义 中 声明 CoOrds 类 的 字段 和 构造 函数 ， 在 另 一 个 分 部 


类 定义 中 声明 成 员 PrintCoOrds。 


代码 


public partial class CoOrds 


{ 
private int x; 
private int y; 
public CoOrds(int x, int y) 
{ 
this.x = x; 
this.y = y; 
} 
} 
public partial class CoOrds 
{ 
public void PrintCoOrds() 
{ 
Console.WriteLine("CoOrds: {0},{1}", x, y); 
} 
} 
class TestCoOrds 
{ 
static void Main() 
{ 
CoOrds myCoOrds = new CoOrds(10, 15); 
myCoOrds.PrintCoOrds(); 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 


// Output: CoOrds: 10,15 


示例 2 
3t BH 
从 下 面 的 示例 可 以 看 出 ， 您 也 可 以 开发 分 部 结构 和 接口 。 


代码 


partial interface ITest 
void Interface Test(); 

partial interface ITest 

1 

} 


partial struct S1 


void Interface Test2(); 


void Struct Test() { ) 


partial struct S1 
{ 


} 


void Struct_Test2() { } 


分 部 方法 


分 部 类 或 结构 可 以 包含 分 部 方法 。 类 的 一 个 部 分 包含 方法 的 签名 。 可 以 在 同一 部 分 
或 另 一 个 部 分 中 定义 可 选 实现 。 如 果 未 提供 该 实现 ， 则 会 在 编译 时 移 除 方法 以 及 对 
方法 的 所 有 调用 。 


分 部 方法 使 类 的 某 个 部 分 的 实施 者 能 够 定义 方法 (类似 于 事件 ) 。 类 的 另 一 部 分 的 
实施 者 可 以 决定 是 否 实现 该 方法 。 如 果 未 实现 该 方法 ， 编 译 器 将 移 除 方 法 签名 以 及 
对 该 方法 的 所 有 调用 。 调 用 该 方法 ， 包 括 调 用 中 的 任何 计算 结果 ， 在 运行 时 没有 任 
可 影响 。 因 此 ， 分 部 类 中 的 任何 代码 都 可 以 随意 地 使 用 分 部 方法 ， 即 使 未 提供 实现 
也 是 如 此 。 如 果 调 用 了 未 实现 的 方法 ， 将 不 会 导致 编译 时 错误 或 运行 时 错误 。 


在 自 定义 生成 的 代码 时 ， 分 部 方法 特别 有 用 。 这 些 方 法 允许 保留 方法 名 称 和 签名 ， 
因此 生成 的 代码 可 以 调用 方法 ， 而 开发 人 员 可 以 决定 是 否 实现 方法 。 与 分 部 类 非常 
类 似 ， 分 部 方法 使 代码 生成 器 创建 的 代码 和 开发 人 员 创 建 的 代码 能 够 协同 工作 ， 而 
会 产生 运行 时 开销 。 

分 部 方法 声明 由 两 个 部 分 组 成 : 定义 和 实现 。 它 们 可 以 位 于 分 部 类 的 不 同 部 分 中 ， 
人 
J 所 有 调用 。 


// Definition in filei.cs 
partial void onNameChanged(); 


// Implementation in file2.cs 
partial void onNameChanged() 


// method body 
} 


e 分 部 方法 声明 必须 以 上 下 文 关键 字 partial 开头 ， 并 且 方 法 必须 返回 void, 
e 分 部 方法 可 以 有 ref 参数 ， 但 不 能 有 out 参数 。 
e 分 部 方法 为 隐 式 private 方法 ， 因 此 不 能 为 virtual 方法 。 


。 分 部 方法 不 能 为 extern 方法 ， 因 为 主体 的 存在 确定 了 方法 是 在 定义 还 是 在 实 
现 。 


e 分 部 方法 可 以 有 static 和 unsafe 修饰 符 。 


e 分 部 方法 可 以 为 泛 型 的 。 约 束 将 放 在 定义 分 部 方法 声明 上 ， 但 也 可 以 选择 重复 
放 在 实现 声明 上 。 参 数 和 类 型 参数 名 称 在 实现 声明 和 定义 声明 中 不 必 相同 。 

e 您 可 以 为 已 定义 并 实现 的 分 部 方法 生成 委托 ， 但 不 能 为 已 经 定义 但 未 实现 的 分 
部 方法 生成 委托 。 


A E 


CH j2 SAS 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 编程 指南 

X (CH 编程 指南 ) 
结构 (C# 编程 指南 ) 
接口 (CH 编程 指南 ) 
分 部 〈 类 型 ) (C4 参考 ) 


匿名 类 型 (CH RIERA) 


匿名 类 型 提供 了 一 种 方便 的 方法 ， 可 用 来 将 一 组 只 读 属性 封装 到 单个 对 象 中 ， 而 无 
需 首 先 显 式 定义 一 个 类 型 。 类 型 名 由 编译 器 生成 ， 并 且 不 能 在 源 代码 级 使 用 。 每 个 
属性 的 类 型 由 编译 器 推断 。 


可 通过 使 用 new 运算 符 和 对 象 初始 值 创建 匿名 类 型 。 有 关 对 象 初始 值 设 定 项 的 详细 
信息 ， 请 参阅 对 象 和 集合 初始 值 设 定 项 (C# 编程 指南 ) o 


以 下 示例 显示 了 用 两 个 名 为 Amount 和 Message 的 属性 进行 初始 化 的 匿名 类 型 。 


var v = new { Amount = 108, Message = "Hello" }; 


// Rest the mouse pointer over v.Amount and v.Message in the follov 
// statement to verify that their inferred types are int and strint 
Console.WriteLine(v.Amount + v.Message); 


SSS 


匿名 类 型 通常 用 在 查询 表达 式 的 select 子 句 中 ， 以 便 返 回 源 序 列 中 每 个 对 象 的 属性 
子 集 。 有 关 查 询 的 详细 信息 ， 请 参阅 LINQ 查询 表达 式 (CH 编程 指南 ) o 


匿名 类 型 包含 一 个 或 多 个 公共 只 读 属性 。 包 含 其 他 种 类 的 类 成 员 (如 方法 或 事件 ) 
为 无 效 。 用 来 初始 化 属性 的 表达 式 不 能 为 null、 匿 名 画 数 或 指针 类 型 。 


最 常见 的 方案 是 用 其 他 类 型 的 属性 初始 化 匿名 类 型 。 在 下 面 的 示例 中 ， 假 定名 为 
Product 的 类 存在 。 类 Product 包括 Color 和 Price 属性 ， 以 及 你 不 感 兴趣 的 其 他 
属性 。 变 量 products 是 Product 对 象 的 集合 。 匿 名 类 型 声明 以 new 关键 字 开 始 。 
声明 初始 化 了 一 个 只 使 用 Product 的 两 个 属性 的 新 类 型 。 这 将 导致 在 查询 中 返回 较 
少数 量 的 数据。 

如 果 你 没有 在 匿名 类 型 中 指定 成 员 名 称 ， 编 译 器 会 为 匿名 类 型 成 员 指 定 与 用 于 初始 
化 这 些 成 员 的 属性 相同 的 名 称 。 必 须 为 使 用 表达 式 初 始 化 的 属性 提供 名 称 ， 如 下 面 
的 示例 所 示 。 在 下 面 示 例 中 ， 匿 名 类 型 的 属性 名 称 都 为 Color 和 Price, 





var productQuery = 
from prod in products 
select new { prod.Color, prod.Price }; 


foreach (var v in productQuery) 


{ 
} 


Console.WriteLine("Color={0}, Price={1}", v.Color, v.Price); 


通常 ， 当 你 使 用 匿名 类 型 来 初始 化 变量 时 ， 可 以 通过 使 用 var 将 变量 作为 隐 式 键 人 
的 本 地 变 来 变量 进行 声明 。 类 型 名 称 无 法 在 变量 声明 中 给 出 ， 因 为 只 有 编译 器 能 访 
问 匿 名 类 型 的 基础 名 称 。 有 关 var 的 详细 信息 ， 请 参阅 隆 式 类 型 的 局 部 变量 (C# 编 
程 指南 ) 。 

可 通过 将 隐 式 键入 的 本 地 变量 与 隐 式 键入 的 数组 相 结合 创建 匿名 键 和 人 的 元 素 的 数 
组 ， 如 下 面 的 示例 所 示 。 


var anonArray = new[] { new { name = "apple", diam = 4 }, new ( nar 


Ji — — B 








匿名 类 型 是 直接 从 对 象 派生 的 类 类 型 ， 并 且 其 无 法 强制 转换 为 除 对 象 外 的 任意 类 
型 。 虽然 你 的 应 用 程序 不 能 访问 它 ， 编 译 器 还 是 提供 了 每 一 个 匿名 类 型 的 名 称 。 从 
公共 语言 运行 时 的 角度 来 看 ， 匿 名 类 型 与 任何 其 他 引用 类 型 没有 什么 不 同 。 

如 果 程 序 集中 的 两 个 或 多 个 匿名 对 象 初始 值 指 定 了 属性 序列 ， 这 些 属性 采用 相同 顺 
序 且 具 有 相同 的 名 称 和 类 型 ， 则 编译 器 将 对 象 视 为 相同 类 型 的 实例 。 它 们 共享 同一 
编译 器 生成 的 类 型 信息 。 

无 法 将 字段 、 属 性 、 时 间或 方法 的 返回 类 型 声明 为 具有 匿名 类 型 。 同 样 ， 你 不 能 将 
方法 、 属 性 、 构 造 本 数 或 索引 器 的 形 参 声明 为 具有 匿名 类 型 。 要 将 匿名 类 型 或 包含 
匿名 类 型 的 集合 作为 参数 传递 给 某 一 方法 ， 可 将 参数 作为 类 型 对 象 进行 声明 。 但 
是 ， 这 样 做 会 使 强 类 型 化 作用 无 效 。 如 果 必 须 存储 查询 结果 或 者 必须 将 查询 结果 传 
北 到 方法 边界 外 部 ， 请 考虑 使 用 普通 的 命名 结构 或 类 而 不 是 匿名 类 型 。 


由 于 匿名 类 型 上 的 Equals 和 GetHashCode 方法 是 根据 方法 属性 的 Equals 和 
GetHashCode 定义 的 ， 因 此 仅 当 同一 匿名 类 型 的 两 个 实例 的 所 有 属性 都 相等 时 ， 
这 两 个 实例 才 相 等 。 


请 参阅 
C# 编程 指南 
对 象 和 集合 初始 值 设 定 项 (C# 编程 指南 ) 


Getting Started with LINQ in C# 
LINQ 查询 表达 式 (CH 编程 指南 ) 


委托 (CH 编程 指南 ) 


delegate 是 表示 对 具有 特定 参数 列表 和 返回 类 型 的 方法 的 引用 的 类 型 。 在 实例 化 委 
托 时 ， 你 可 以 将 其 实例 与 任何 具有 兼容 签名 和 返回 类 型 的 方法 相关 联 。 你 可 以 通过 
委托 实例 调用 方法 。 


委托 用 于 将 方法 作为 参数 传递 给 其 他 方法 。 事 件 处 理 程序 就 是 通过 委托 调用 的 方 
法 。 你 可 以 创建 一 个 自 定义 方法 ， 当 发 生 特定 事件 时 ， 某 个 类 (如 Windows 控 
件 ) 就 可 以 调用 你 的 方法 。 下 面 的 示例 演示 了 一 个 委托 声明 : 


public delegate int PerformCalculation(int x, int y); 


可 将 任何 可 访问 类 或 结构 中 与 委托 类 型 匹配 的 任何 方法 分 配给 委托 。 该 方法 可 以 是 
静态 方法 ， 也 可 以 是 实例 方法 。 这 样 便 能 通过 编程 方式 来 更 改 方法 调用 ， 还 可 以 向 
现 有 类 中 插入 新 代码 。 

8 注意 

在 方法 重 载 的 上 下 文中 ， 方 法 的 签名 不 包括 返回 值 。 但 在 委托 的 上 下 文中 ， 签 
名 包括 返回 值 。 换 句 话 说， 方法 和 委托 必须 具有 相同 的 返回 类 型 。 


将 方法 作为 参数 进行 引用 的 能 力 使 委托 成 为 定义 回调 方法 的 理想 选择 。 例 如 ， 对 比 
较 两 个 对 象 的 方法 的 引用 可 以 作为 参数 传递 到 排序 算法 中 。 由 于 比较 代码 在 一 个 单 
独 的 过 程 中 ， 因 此 可 通过 更 常见 的 方式 编写 排序 算法 。 


委托 概述 


委托 具有 以 下 属性 : 

e 委托 类 似 于 C++ 函数 指针 ， 但 它们 是 类 型 安全 的 。 

e 委托 允许 将 方法 作为 参数 进行 传递 。 

e 委托 可 用 于 定义 回调 方法 。 

委托 可 以 链接 在 一 起 ; 例如 ， 可 以 对 一 个 事件 调用 多 个 方法 。 


方法 不 必 与 委托 类 型 完全 匹配 。 有 关 详 细 信 息 ， 请 参阅 在 委托 中 使 用 变 体 (CE 
和 Visual Basic) 。 


C# 2.0 版 引入 了 匿名 方法 的 概念 ， 此 类 方法 允许 将 代码 块 作为 参数 传递 来 代替 
单独 定义 的 方法 。C# 3.0 引入 了 Lambda 表达 式 ， 利 用 它们 可 以 更 简练 地 编写 
内 联 代码 块 。 匿 名 方法 和 Lambda 表达 式 (在 某 些 上 下 文中 ) 都 可 编译 为 委托 
类 型 。 这 些 功 能 现在 统称 为 匿名 函数 。 有 关 lambda 表达 式 的 更 多 信息 ， 请 参 
WERE (CH 编程 指南 ) 。 
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本 节 内 容 


e 使 用 委托 (CH 编程 指南 ) 

e When to Use Delegates Instead of Interfaces (C£ Programming Guide) 
e 带 有 命名 方法 的 委托 与 带 有 匿名 方法 的 委托 (CH 编程 指南 ) 

e 匿名 方法 (CH 编程 指南 ) 

在 委托 中 使 用 变 体 (C# 和 Visual Basic) 

e 如何 : 合并 委托 (多 路 广播 委托 ) (CH 编程 指南 ) 

。 如 何 : 声明 、 实 例 化 和 使 用 委托 (C# 编程 指南 ) 


C# 语言 规范 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


重要 章节 


http://go.microsoft.com/fwlink/?Linkld=195395 
http://go.microsoft.com/fwlink/?Linkld=195369 
http://go.microsoft.com/fwlink/?Linkld=195418 
http://go.microsoft.com/fwlink/?Linkld=195412 


请 参阅 

Delegate 

C# 编程 指南 

事件 (CH 编程 指南 ) 
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使 用 委托 (CH 编程 指南 ) 


委托 是 安全 封装 方法 的 类 型 ， 类 似 于 C 和 C++ 中 的 函数 指针 。 与 C 函数 指针 不 同 
的 是 ， 委 托 是 面向 对 象 的 、 类 型 安全 的 和 可 靠 的 。 委 托 的 类 型 由 委托 的 名 称 确定 。 
以 下 示例 声明 名 为 Del 的 委托 ， 该 委托 可 以 封装 采用 字符 串 作为 参数 并 返回 void 
的 方法 : 


public delegate void Del(string message); 


委托 对 象 通常 通过 提供 委托 将 封装 的 方法 的 名 称 或 使 用 匿名 方法 构造 。 对 委托 进行 
实例 化 后 ， 委 托 会 将 对 其 进行 的 方法 调用 传递 到 该 方法 。 调 用 方 传递 到 委托 的 参数 
将 传递 到 该 方法 ， 并 且 委 托 会 将 方法 的 返回 值 MRA) 返回 到 调用 方 。 这 被 称 为 
调用 委托 。 实 例 化 的 委托 可 以 按 封装 的 方法 本 身 进行 调用 。 例 如 : 


// Create a method for a delegate. 
public static void DelegateMethod(string message) 


System.Console.WriteLine(message); 


// Instantiate the delegate. 
Del handler - DelegateMethod; 


// Call the delegate. 
handler("Hello World"); 


委托 类 型 派生 自 .NET Framework 中 的 Delegate 类 。 委 托 类 型 是 封装 的 ， 它 们 不 
能 派生 出 其 他 类 ， 也 不 能 从 Delegate 派生 出 自 定义 类 。 由 于 实例 化 的 委托 是 一 个 
对 象 ， 因 此 可 以 作为 参数 传递 或 分 配给 一 个 属性 。 这 人 允许 方法 作为 参数 接受 委托 并 
在 稍 后 调用 委托 。 这 被 称 为 异步 回调 ， 是 在 长 进程 完成 时 通知 调用 方 的 常用 方法 。 
当 以 这 种 方式 使 用 委托 时 ， 使 用 委托 的 代码 不 需要 知道 要 使 用 的 实现 方法 。 功 能 类 
似 于 封装 接口 提供 的 功能 。 


回调 的 另 一 个 常见 用 途 是 定义 自 定义 比较 方法 并 将 该 委托 传递 到 短 方法 。 它 允许 调 
用 方 的 代码 成 为 排序 算法 的 一 部 分 。 以 下 示例 方法 使 用 Del 类 型 作为 参数 : 
public void MethodwithCallback(int parami, int param2, Del callbacl 


callback("The number is: " + (param1 + param2).ToString()); 








然后 ， 你 可 以 将 上 面 创 建 的 委托 传递 到 该 方法 : 


MethodwithCallback(1, 2, handler); 


并 将 以 下 输出 接收 到 控制 台 : 
The number is: 3 


以 抽象 方式 使 用 委托 时 ，MethodWithCallback 不 需要 直接 调用 控制 台 ， 记 住 ， 其 
不 必 设 计 为 具有 控制 台 。 MethodWithCallback 的 作用 是 简单 准 各 字符 串 并 将 字符 
串 传递 到 其 他 方法 。 由 于 委托 的 方法 可 以 使 用 任意 数量 的 参数 ， 此 功能 特别 强大 。 


当 委 托 构造 为 封 变 实例 方法 时 ， 委托 将 同时 引用 实例 和 方法 。 委 托 不 知道 除 其 所 封 

装 方法 以 外 的 实例 类 型 ， 因 此 委托 可 以 引用 任何 类 型 的 对 象 ， 只 要 该 对 象 上 有 与 委 
托 签名 匹配 的 方法 。 当 委托 构造 为 封装 静态 方法 时 ， 委 托 仅 引用 方法 。 请 考虑 以 下 
声明 : 


public class MethodClass 


{ 
public void Methodi(string message) { } 
public void Method2(string message) { } 


加 上 之 前 显示 的 静态 DelegateMethod， 我 们 现在 已 有 三 个 Del 实例 可 以 封装 的 方 
"s 


调用 时 ， 委 托 可 以 调用 多 个 方法 。 这 被 称 为 多 播 。 知 要 向 委托 的 方法 列表 (调用 列 
R) 添加 其 他 方法 ， 只 需 使 用 加 法 运算 符 或 加 法 赋值 运算 符 ( + "sk" += 7) 添加 两 个 | 
委托 。 例 如 : 


MethodClass obj = new MethodClass(); 
Del di = obj.Method1; 

Del d2 - obj.Method2; 

Del d3 = DelegateMethod; 


//Both types of assignment are valid. 
Del allMethodsDelegate = d1 + d2; 
allMethodsDelegate += d3; 


tat, allMethodsDelegate 的 调用 列表 中 包含 三 个 方法 ， 分 别 为 Method1、 
Method2 和 DelegateMethod。 原 有 的 三 个 委托 (d1、d2 和 d3) 保持 不 变 。 调 用 
allMethodsDelegate 时 ， 将 按 顺序 调用 所 有 三 个 方法 。 如 果 委 托 使 用 引用 参数 ， 引 
用 将 按 相反 的 顺序 传递 到 所 有 这 三 个 方法 ， 并 且 一 种 方法 进行 的 任何 更 改 都 将 在 另 
一 种 方法 上 见 到 。 当 方法 引发 未 在 方法 内 捕获 到 的 异常 时 ， 该 异常 将 传递 到 委托 的 
调用 方 ， 并 且 不 会 调用 调用 列表 中 的 后 续 方 法 。 如 果 委 托 具 有 返回 值 和 /或 输出 参 
数 ， 它 将 返回 上 次 调用 方法 的 返回 值 和 参数 。 若 要 删除 调用 列表 中 的 方法 ， 请 使 用 
减法 运算 符 或 减法 赋值 运算 符 (+=) 。 例 如 : 


//remove Methodi 
allMethodsDelegate -- d1; 


// copy AllMethodsDelegate while removing d2 
Del oneMethodDelegate - allMethodsDelegate - d2; 


由 于 委托 类 型 派生 自 System.Delegate， 因 此 可 以 在 委托 上 调用 该 类 定义 的 方法 和 
属性 。 例 如 ， 若 要 查询 委托 调用 列表 中 方法 的 数量 ， 你 可 以 编写 : 


int invocationCount = di.GetInvocationList().GetLength(0); 


调用 列表 中 具有 多 个 方法 的 委托 派生 自 MulticastDelegate, RX [ECT 
System.Delegate 的 子 类 。 由 于 这 两 个 类 都 支持 GetlnvocationList， 因 此 在 其 他 
情况 下 ， 上 述 代码 也 将 产生 作用 。 


多 播 委 托 广泛 用 于 事件 匀 理 中 。 事 件 源 对 象 将 事件 通知 发 送 到 已 注册 接收 该 事件 的 
接收 方 对 象 。 若 要 注册 一 个 事件 ， 接 收 方 需要 创建 用 于 人 处理 该 事件 的 方法 ， 然 后 为 
该 方法 创建 委托 并 将 委托 传递 到 事件 源 。 事 件 发 生 时 ， 源 调用 委托 。 然 后 ， 委 托 将 
对 接收 方 调用 事件 处 理 方法 ， 从 而 提供 事件 数据 。 给 定 事件 的 委托 类 型 由 事件 源 确 
定 。 有 关 详 细 信 息 ， 请 参阅 事件 (CH 编程 指南 ) o 
在 编译 时 比较 分 配 的 两 个 不 同类 型 的 委托 将 导致 编译 错误 。 如 果 委 托 实例 是 静态 的 
System.Delegate 类 型 ， 则 人 允许 比较 ， 但 在 运行 时 将 返回 false。 例 如 : 
delegate void Delegate1(); 
delegate void Delegate2(); 
static void method(Delegate1 d, Delegate2 e, System.Delegate f) 
1 
// Compile-time error. 
//Console.WriteLine(d == e); 
// OK at compile-time. False if the run-time type of f 


// is not the same as that of d. 
System.Console.WriteLine(d == f); 


请 参阅 
C# 编程 指南 
委托 (CH 编程 指南 ) 


在 委托 中 使 用 变 体 (C# 和 Visual Basic) 
委托 中 的 变 体 (C# 和 Visual Basic) 
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xt Func 和 Action 泛 型 委托 使 用 变 体 (C# 和 Visual Basic) 
事件 (CH 编程 指南 ) 
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带 有 命名 方法 的 委托 与 带 有 匿名 方法 的 委托 (CH 编 
程 指南 ) 
委托 可 以 与 命名 方法 关联 。 使 用 命名 方法 对 委托 进行 实例 化 时 ， 该 方法 将 作为 参数 
传递 ， 例 如 : 


// Declare a delegate: 
delegate void Del(int x); 


// Define a named method: 
void Dowork(int k) ( /* ... */ } 


// Instantiate the delegate using the method as a parameter: 
Del d - obj.DoWork; 


这 被 称 为 使 用 命名 的 方法 。 使 用 命名 方法 构造 的 委托 可 以 封装 静态 方法 或 实例 方 

法 。 在 早期 版 本 的 C# 中 ， 命 名 方法 是 对 委托 进行 实例 化 的 唯一 方式 。 但 是 ， 在 不 
希望 付出 创建 新 方法 的 系统 开销 时 ，C# 使 您 可 以 对 委托 进行 实例 化 ， 并 立即 指定 
委托 在 被 调用 时 将 处 理 的 代码 块 。 代 码 块 可 以 包含 lambda 表达 式 或 匿名 方法 。 有 
关 更 多 信息 ， 请 参见 BAW (CH 编程 指南 ) o 


备注 
作为 委托 参数 传递 的 方法 必须 与 委托 声明 具有 相同 的 签名 。 


委托 实例 可 以 封装 静态 或 实例 方法 。 


尽管 委托 可 以 使 用 out 参数 ， 但 建议 您 不 要 将 其 用 于 多 路 广播 事件 委托 ， 因 为 您 无 
法 知道 哪个 委托 将 被 调用 。 


示例 1 


以 下 是 声明 及 使 用 委托 的 一 个 简单 示例 。 注 意 ， 委 托 Del 和 关联 的 方法 
MultiplyNumbers 具有 相同 的 签名 


// Declare a delegate 
delegate void Del(int i, double j); 


class MathClass 


{ 
static void Main() 
{ 
MathClass m = new MathClass(); 
// Delegate instantiation using "MultiplyNumbers" 
Del d - m.MultiplyNumbers; 
// Invoke the delegate object. 
System.Console.WriteLine("Invoking the delegate using 'Mult! 
for (int i = 1; i <= 5; i++) 
d(i, 2); 
} 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
// Declare the associated method. 
void MultiplyNumbers(int m, double n) 
f 
System.Console.write(m * n+" "); 
} 
} 
/* Output: 
Invoking the delegate using 'MultiplyNumbers': 
246 8 10 
5 





示例 2 


在 下 面 的 示例 中 ， 一 个 委托 被 同时 映射 到 静态 方法 和 实例 方法 ， 并 分 别 返 回 特定 的 


信息 。 


// Declare a delegate 
delegate void Del(); 


class SampleClass 


public void InstanceMethod() 


t 
System.Console.WriteLine("A message from the instance meth: 
J 
static public void StaticMethod() 
{ 
System.Console.WriteLine("A message from the static method 
} 
} 
class TestSampleClass 
{ 
static void Main() 
{ 
SampleClass sc = new SampleClass(); 
// Map the delegate to the instance method: 
Del d = sc.InstanceMethod; 
d(); 
// Map to the static method: 
d - SampleClass.StaticMethod; 
d(); 
} 
/* Output: 
A message from the instance method. 
A message from the static method. 
=y 





请 参阅 


CH 编程 指南 

委托 (CH 编程 指南 ) 

匿名 方法 (CH 编程 指南 ) 

如 何 : 合并 委托 (多 路 广播 委托 ) (CH 编程 指南 ) 
事件 (CH 编程 指南 ) 


如 何 : 合并 委托 (多 路 广播 委托 ) (CH 编程 指 两 ) 


本 示例 演示 如 何 创建 多 播 委 托 。 委托 对 象 的 一 个 有 用 属性 是 : 可 以 使 用 + 运算 符 
将 多 个 对 象 分 配给 一 个 委托 实例 。 多 播 委 托 包 含 已 分 配 委托 的 列表 。 在 调用 多 播 委 
托 时 ， 它 会 按 顺序 调用 列表 中 的 委托 。 只 能 合并 相同 类 型 的 委托 。 


- 运算 符 可 用 于 从 多 播 委托 中 移 除 组 件 委托 。 


using System; 


// Define a custom delegate that has a string parameter and return: 
delegate void CustomDel(string s); 


class TestClass 


( 


// Define two methods that have the same signature as CustomDe: 
static void Hello(string s) 


{ 
System.Console.WriteLine(" Hello, (0j!", s); 
} 
static void Goodbye(string s) 
{ 
System.Console.WriteLine(" Goodbye, {0}!", s); 
J 
static void Main() 
{ 


// Declare instances of the custom delegate. 
CustomDel hiDel, byeDel, multiDel, multiMinusHiDel; 


// In this example, you can omit the custom delegate if yol 
// want to and use Action<string> instead. 
//Action<string> hiDel, byeDel, multiDel, multiMinusHiDel; 


// Create the delegate object hiDel that references the 
// method Hello. 
hiDel = Hello; 


// Create the delegate object byeDel that references the 
// method Goodbye. 
byeDel = Goodbye; 


// The two delegates, hiDel and byeDel, are combined to 
// form multiDel. 
multiDel = hiDel + byeDel; 


// Remove hiDel from the multicast delegate, leaving byeDe- 
// which calls only the method Goodbye. 


multiMinusHiDel - multiDel - hiDel; 


Console.WriteLine("Invoking delegate hiDel:"); 
hiDel("A"); 
Console.WriteLine("Invoking delegate byeDel:"); 
byeDel("B"); 
Console.WriteLine("Invoking delegate multiDel:"); 
multiDel("C"); 
Console.WriteLine("Invoking delegate multiMinusHiDel:"); 
multiMinusHiDel("D"); 

j 


/* Output: 
Invoking delegate hiDel: 
Hello, A! 
Invoking delegate byeDel: 
Goodbye, B! 
Invoking delegate multiDel: 
Hello, C! 
Goodbye, C! 
Invoking delegate multiMinusHiDel: 
Goodbye, D! 





请 参阅 


MulticastDelegate 
C# 编程 指南 
事件 (CH 编程 指南 ) 


如 何 : 声明 、 实 例 化 和 使 用 委托 (CH 编程 指南 ) 


在 C# 1.0 及 更 高 版 本 中 ， 可 以 按 以 下 示例 所 示 声 明 委 托 。 


// Declare a delegate. 
delegate void Del(string str); 


// Declare a method with the same signature as the delegate. 
static void Notify(string name) 


i 
j 


Console.WriteLine("Notification received for: {0}", name); 


// Create an instance of the delegate. 
Del deli = new Del(Notify); 


CH 2.0 提供 了 更 简单 的 方法 来 编写 上 面 的 声明 ， 如 以 下 示例 所 示 。 


// C# 2.0 provides a simpler way to declare an instance of Del. 
Del del2 - Notify; 


在 C 2.0 及 更 高 版 本 中 ， 还 可 以 使 用 匿名 方法 来 声明 和 初始 化 委托 ， 如 以 下 示例 
所 示 。 


// Instantiate Del by using an anonymous method. 
Del del3 - delegate(string name) 
{ Console.WriteLine("Notification received for: {0}", name); }, 


E — 


在 C# 3.0 及 更 高 版 本 中 ， 还 可 以 使 用 Lambda 表达 式 来 声明 和 实例 化 委托 ， 如 以 
下 示例 所 示 。 





// Instantiate Del by using a lambda expression. 
Del del4 = name => { Console.WriteLine("Notification received for 


有 关 更 多 信息 ， 请 参见 Lambda 表达 式 (CH 编程 指南 ) 。 





下 面 的 示例 阐释 声明 、 实 例 化 和 使 用 委托 。 BookDB 类 封装 一 个 书店 数据 库 ， 它 维 
一 个 书籍 数据 库 。 它 公 开 ProcessPaperbackBooks 方法 ， 该 方法 在 数据 库 中 查 
找 所 有 平装 书 ， 并 对 每 本 平装 书 调用 一 个 委托 。 使 用 的 delegate 类 型 名 为 
SH Test 类 使 用 该 类 打印 平装 书 的 书 名 和 平均 价格 。 


委托 的 使 用 促进 了 书店 数据 库 和 客户 代码 之 间 功 能 的 恨 好 分 隔 。 客 户 代码 不 知道 书 
籍 的 存储 方式 和 书店 代码 查找 平装 书 的 方式 。 书 店 代码 也 不 知道 找到 平装 书后 将 对 
平装 书 执行 什么 义理 。 


// A set of classes for handling a bookstore: 
namespace Bookstore 


( 


using System.Collections; 


// Describes a book in the book list: 
public struct Book 


{ 
public string Title; // Title of the book. 
public string Author; // Author of the book. 
public decimal Price; // Price of the book. 
public bool Paperback; // Is it paperback? 
public Book(string title, string author, decimal price, boc 
{ 
Title = title; 
Author = author; 
Price = price; 
Paperback = paperBack; 
} 
} 


// Declare a delegate type for processing a book: 
public delegate void ProcessBookDelegate(Book book); 


// Maintains a book database. 
public class BookDB 


// List of all books in the database: 
ArrayList list = new ArrayList(); 


// Add a book to the database: 


public void AddBook(string title, string author, decimal pi 


list.Add(new Book(title, author, price, paperBack)); 


} 


// Call a passed-in delegate on each paperback book to proc 
public void ProcessPaperbackBooks(ProcessBookDelegate proce 


foreach (Book b in list) 


if (b.Paperback) 


// Calling the delegate: 
processBook(b); 


j 


// Using the Bookstore classes: 
namespace BookTestClient 


{ 


using Bookstore; 


// Class to total and average prices of books: 
class PriceTotaller 


{ 


int countBooks = 0; 
decimal priceBooks - 0.0m; 


internal void AddBookToTotal(Book book) 
{ 


countBooks += 1; 
priceBooks += book.Price; 


j 


internal decimal AveragePrice() 


{ 
} 


return priceBooks / countBooks; 


} 


// Class to test the book database: 
class TestBookDB 
{ 
// Print the title of the book. 
static void PrintTitle(Book b) 


{ 
} 


// Execution starts here. 
static void Main() 


D 


System.Console.WriteLine(" 10) b.Title); 


BookDB bookDB = new BookDB(); 


// Initialize the database with some books: 
AddBooks (bookDB) ; 


// Print all the titles of paperbacks: 
System.Console.WriteLine("Paperback Book Titles:"); 


// Create a new delegate object associated with the st: 
// method Test.PrintTitle: 
bookDB.ProcessPaperbackBooks(PrintTitle); 


// Get the average price of a paperback by using 
// a PriceTotaller object: 
PriceTotaller totaller - new PriceTotaller(); 


// Create a new delegate object associated with the nor 
// method AddBookToTotal on the object totaller: 
bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal); 


System.Console.WriteLine("Average Paperback Book Price 
totaller.AveragePrice()); 


j 


// Initialize the book database with some test books: 
static void AddBooks(BookDB bookDB) 


{ 
bookDB.AddBook("The C Programming Language", "Brian W. 
bookDB.AddBook("The Unicode Standard 2.0", "The Unicode 
bookDB.AddBook("The MS-DOS Encyclopedia", "Ray Duncan", 
bookDB.AddBook("Dogbert's Clues for the Clueless", "SC 
} 
} 
} 
/* Output: 


Paperback Book Titles: 

The C Programming Language 

The Unicode Standard 2.0 

Dogbert's Clues for the Clueless 
Average Paperback Book Price: $23.97 
a7 


SS = 


可 靠 编程 


。 声明 委托 。 
下 面 的 语句 声明 一 个 新 的 委托 类 型 。 





public delegate void ProcessBookDelegate(Book book); 


每 个 委托 类 型 都 描述 参数 的 数目 和 类 型 ， 以 及 它 可 以 封装 的 方法 的 返回 值 类 
型 。 每 当 需 要 一 组 新 的 参数 类 型 或 新 的 返回 值 关 型 时 ， 都 必须 声明 一 个 新 的 委 
托 关 型 。 


。 实例 化 委托 。 


声明 了 委托 类 型 后 ， 必 须 创 建委 托 对 象 并 使 之 与 特定 方法 关联 。 在 上 一 个 示例 
中 ， 您 通过 按 下 面 示例 中 的 方式 将 PrintTitle 方法 传递 到 
ProcessPaperbackBooks 方法 来 实现 这 一 点 : 


bookDB.ProcessPaperbackBooks(PrintTitle); 


这 将 创建 与 静态 方法 Test.PrintTitle 关联 的 新 委托 对 象 。 类似 地 ， 对 象 totaller 
的 非 静态 方法 AddBookToTotal 是 按 下 面 示例 中 的 方式 传递 的 : 


bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal); 


在 两 个 示例 中 ， 都 向 ProcessPaperbackBooks 方法 传递 了 一 个 新 的 委托 对 


委托 创建 后 ， 它 的 关联 方法 就 不 能 更 改 ; 委托 对 象 是 不 可 变 的 。 
e 调用 委托 。 


创建 委托 对 象 后 ， 通 常 籽 委托 对 象 传递 给 将 调用 该 委托 的 其 他 代码 。 通 过 委托 
对 象 的 名 称 (后 面 跟着 要 传递 给 委托 的 参数 ， 括 在 括号 内 ) 调用 委托 对 象 。 下 
面 是 委托 调用 的 示例 : 


processBook(b); 


与 本 例 一 样 ， 可 以 通过 使 用 BeginInvoke 和 EndInvoke 方法 同步 或 异步 调用 
Eo 


请 参阅 

C# 编程 指南 

事件 (CH 编程 指南 ) 
委托 (CH 编程 指南 ) 


枚 举 类 型 (CH 编程 指责) 


枚 举 类 型 (也 称 为 枚 举 ) 为 定义 一 组 可 以 赋 给 变量 的 命名 整数 常量 提供 了 一 种 有 效 
的 方法 。 例 如 ， 假 设 您 必须 定义 一 个 变量 ， 该 变量 的 值 表 示 一 周 中 的 一 天 。 该 变量 
只 能 存储 七 个 有 意义 的 值 。 若 要 定义 这 些 值 ， 可 以 使 用 枚 举 类 型 。 枚 举 类 型 是 使 用 
enum 关 键 字 声 明 的 。 


enum Days { Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, : 
enum Months : byte ( Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, ( 


B a————À— Á—————— eee 


默认 情况 下 ， 枚 举 中 每 个 元 素 的 基础 类 型 是 int。 可 以 使 用 冒号 指定 另 一 种 整数 值 类 
型 ， 如 前 面 的 示例 所 示 。 有 关 可 能 的 类 型 的 完整 列表 ， 请 参见 enum (C£ 参考 ) 。 


可 以 通过 转换 验证 基础 数值 与 基础 类 型 ， 如 下 例 所 示 。 





Days today = Days.Monday; 
int dayNumber -(int)today; 
Console.WriteLine("([0) is day number #{1}.", today, dayNumber); 


Months thisMonth - Months.Dec; 
byte monthNumber - (byte)thisMonth; 
Console.WriteLine("{0} is month number #{1}.", thisMonth, monthNuml 


// Output: 
// Monday is day number #1. 
// Dec is month number #11. 


[s aM HK MH ———— atur QUA. SP Í 
以 下 是 使 用 枚 举 而 不 使 用 数值 类 型 的 好 处 : 

e 明确 为 客户 端 代码 指定 哪些 值 是 变量 的 有 效 值 。 

e 在 Visual Studio rh, IntelliSense 列 出 定义 的 值 。 


如 果 未 在 枚 举 数 列表 中 指定 元 素 的 值 ， 则 值 将 自动 按 1 递增 。 在 前 面 的 示例 中 ， 
Days.Sunday 的 值 为 0，Days.Monday 的 值 为 1， 依 此 类 推 。 创 建新 的 Days xt RK 
时 ， 如 果 不 显 式 为 其 赋值 ， 则 它 将 具有 默认 值 Days.Sunday (0)。 创 建 枚 举 时 ， 应 
选择 最 合理 的 默认 值 并 赋 给 它 一 个 雳 值 。 这 便 使 得 只 要 在 创建 枚 举 时 未 为 其 显 式 赋 
值 ， 则 所 创建 的 全 部 枚 举 都 将 具有 该 默认 值 。 


WR y S meetingDay 的 类 型 为 Days， 则 只 能 将 Days 定义 的 某 个 值 赋 给 它 (LE 
显 式 强制 转换 ) 。 如 果 会 议 日 期 更 改 ， 可 以 将 Days REIXA NRA meetingDay : 





Days meetingDay - Days.Monday; 
VUF 
meetingDay = Days.Friday; 


区 注意 
可 以 将 任意 整数 值 赋 给 meetingDay。 例 如 ， 代 码 行 meetingDay = (Days) 42 
不 会 产生 错误 。 但 也 不 应 该 这 样 做 ， 因 为 默认 约定 的 是 枚 举 变量 只 容纳 枚 举 定 
义 的 值 之 一 。 将 任意 值 赋 给 枚 举 类 型 的 变量 很 有 可 能 会 导致 错误 。 

可 以 将 任意 值 赋 给 枚 举 类 型 的 枚 举 数 列表 中 的 元 素 ， 也 可 以 使 用 计算 值 : 


enum MachineState 


{ 

PowerOff = 0, 

Running - 5, 

Sleeping - 10, 

Hibernating = Sleeping + 5 
} 


枚 举 类 型 作为 位 标 坊 


可 以 使 用 枚 举 类 型 定义 位 标志 ， 从 而 使 该 枚 举 类 型 的 实例 可 以 存储 枚 举 数 列表 中 定 
义 的 值 的 任意 组 合 。 (当然 ， 某 些 组 合 在 您 的 程序 代码 中 可 能 没有 意义 或 不 允许 使 
用 。 ) 


创建 位 标志 枚 举 的 方法 是 应 用 System.FlagsAttribute 特性 并 适当 定义 一 些 值 ， 以 便 
可 以 对 这 些 值 执行 AND. OR, NOT 和 XOR 按 位 运算 。 在 位 标志 枚 举 中 包含 一 个 
GAS (表示 “未 设置 任何 标志 ”) 的 命名 常量 。 如 果 需 值 不 表示 “未 设置 任何 标志 ”， 
Wig hE A tei EF ho 


在 下 面 的 示例 中 ， 定 义 了 Days 枚 举 的 另 一 个 版 本 ， 命 名 为 Days2, Days2 具有 
Flags 特性 ， 且 它 的 每 个 值 都 是 2 的 若干 次 辕 ， 指 数 依 次 递增 。 这 样 ， 您 将 能 够 创 
建 值 为 Days2.Tuesday 和 Days2.Thursday 的 Days2 = =. 


[Flags] 
enum Days2 


{ 
None = 0X0, 
Sunday = 0x1, 
Monday = 0x2, 


Tuesday = 0x4, 
Wednesday = 0x8, 
Thursday = 0x10, 
Friday - 0x20, 
Saturday - 0x40 


class MyClass 


i 
} 


Days2 meetingDays = Days2.Tuesday | Days2.Thursday; 


若 要 在 某 个 枚 举 上 设置 标志 ， 请 使 用 按 位 OR 运算 符 ， 如 下 面 的 示例 所 示 : 


// Initialize with two flags using bitwise OR. 
meetingDays - Days2.Tuesday | Days2.Thursday; 


// Set an additional flag using bitwise OR. 
meetingDays - meetingDays | Days2.Friday; 


Console.WriteLine("Meeting days are {0}", meetingDays); 
// Output: Meeting days are Tuesday, Thursday, Friday 


// Remove a flag using bitwise XOR. 

meetingDays - meetingDays ^ Days2.Tuesday; 
Console.WriteLine("Meeting days are {0}", meetingDays); 
// Output: Meeting days are Thursday, Friday 


若 要 确定 是 否 设置 了 特定 标志 ， 请 使 用 按 位 AND 运算 ， 如 下 面 的 示例 所 示 : 


// Test value of flags using bitwise AND. 

bool test - (meetingDays & Days2.Thursday) -- Days2.Thursday; 
Console.WriteLine("Thursday (0) a meeting day.", test == true ? "is 
// Output: Thursday is a meeting day. 





DIETS F A a 2 要 考虑 的 事项 的 更 多 信息 ， 
请 参见 System.Enum。 


使 用 System.Enum 方法 发 现 和 操作 枚 举 值 


所 有 枚 举 都 是 System.Enum 类 型 的 实例 。 不 能 从 System.Enum 派生 新 类 ， 但 可 
以 使 用 它 的 方法 发 现 有 关 枚 举 实例 中 的 值 的 信息 以 及 操作 这 些 值 。 


string s = Enum.GetName(typeof(Days), 4); 
Console.WriteLine(s); 


Console.WriteLine("The values of the Days Enum are:"); 

foreach (int i in Enum.GetValues(typeof(Days))) 
Console.WriteLine(i); 

Console.WriteLine("The names of the Days Enum are:"); 


foreach (string str in Enum.GetNames(typeof(Days))) 
Console.WriteLine(str); 


有 关 更 多 信息 ， 请 参见 AllIMembers. 下 System.Enum。 


此 外 ， 还 可 以 使 用 扩展 方法 为 枚 举 创 建新 方法 。 有 关 更 多 信息 ， 请 参见 如 何 : 为 枚 
举 创建 新 方法 (CH 编程 指南 ) 。 


= 
PREY 
更 多 有 关 变 量 在 开始 Visual c# 2010 
请 参阅 
System.Enum 


CH 编程 指南 
enum (C# 参考 ) 


事件 (CH 编程 指南 ) 
类 或 对 象 可 以 通过 事件 向 其 他 类 或 对 象 通 知 发 生 的 相关 事情 。 改 送 或 引发 ) 事件 
的 类 称 为 "发 行者 ”接收 ( 或 处理 ) 事件 的 类 称 为 "订户 ”。 


在 典型 的 C# Windows 窗 体 或 Web 应 用 程序 中 ， 可 订阅 由 控件 (如 按钮 和 列表 
HE) 引发 的 事件 。 可 使 用 Visual CH 集成 开发 环境 (IDE) 来 浏览 控件 发 布 的 事件 ， 
选择 要 处 理 的 事件 。|DE 会 自动 添加 空 事件 处 理 程序 方法 和 订阅 事件 的 代码 。 有 关 
更 多 信息 ， 请 参见 如 何 : 订阅 和 取消 订阅 事件 (CH 编程 指南 ) o 


事件 概述 


事件 具有 以 下 特点 : 
e 发 行者 确定 何 时 引发 事件 ， 订 户 确 定 执行 何 种 操作 来 响应 该 事件 。 
e 一 个 事件 可 以 有 多 个 订户 。 一 个 订户 可 义理 来 自 多 个 发 行者 的 多 个 事件 。 
e 没有 订户 的 事件 永远 也 不 会 引发 。 
E 例如 ， 图 形 用 户 界面 中 的 按钮 单 击 或 菜单 选择 操 


o 


如 果 一 个 事件 有 多 个 订户 ， 当 引发 该 事件 时 ， 会 同步 调用 多 个 事件 处 理 程序 。 
要 异步 调用 事件 ， 请 参见 Calling Synchronous Methods Asynchronously。 


e 在 .NET Framework 类 库 中 ， 事 件 是 基于 EventHandler 委托 和 EventArgs 基 
Æ 


类 的 


有 关 更 多 信息 ， 请 参见 : 
e 如何 : 订阅 和 取消 订阅 事件 (CH 编程 指南 ) 
e 如 何 : 发 布 符合 .NET Framework 准则 的 事件 (CH 编程 指南 ) 
e 如何 : 在 派生 类 中 引发 基 类 事件 (CH 编程 指南 ) 
e 如何 : 实现 接口 事件 (CH 编程 指南 ) 
线程 同步 (C# 和 Visual Basic) 
如 何 : 使 用 字典 存储 事件 实例 (CH 编程 指南 ) 
e 如 何 : 实现 自 定义 事件 访问 器 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


重要 章节 


http://go.microsoft.com/fwlink/?Linkld=195395 
http://go.microsoft.com/fwlink/?Linkld=195369 
http://go.microsoft.com/fwlink/?Linkld=195418 
http://go.microsoft.com/fwlink/?Linkld=195412 


请 参阅 

EventHandler 

C# 编程 指南 

委托 (C# 编程 指南 ) 

在 Windows 窗 体 中 创建 事件 处 理 程序 


Multithreaded Programming with the Event-based Asynchronous Pattern 


事件 (CH 编程 指南 ) 
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如 何 : 订阅 和 取消 订阅 事件 (CH 编程 指南 ) 


如 果 您 想 编写 引发 事件 时 调用 的 自 定义 代码 ， 则 可 以 订阅 由 其 他 类 发 布 的 事件 。 例 
如 ， 可 以 订阅 某 个 按钮 的 click 事件 ， 以 使 应 用 程序 在 用 户 单 击 该 按钮 时 执行 一 些 
有 用 的 操作 。 


使 用 Visual Studio IDE 订阅 事件 


1. 如 果 看 不 到 “属性 ”窗口 ， 请 在 “设计 ”视图 中 ， 右 击 要 为 其 创建 事件 处 理 程序 的 
窗 体 或 控件 ， 然 后 选择 “属性 ”。 


2. 在 “属性 ”窗口 的 顶部 ， 单 击 “ 事 件 ” 图 标 。 
3. 双击 要 创建 的 事件 ， 例 如 Load 事件 。 


Visual C# 会 创建 一 个 空 事 件 处 理 程序 方法 ， 并 将 其 添加 到 您 的 代码 中 。 或 
者 ， 您 也 可 以 在 “代码 ”视图 中 手动 添加 人 代码。 例如， 下面 的 代码 行 声明 了 一 个 
在 Form 类 引发 Load 事件 时 调用 的 事件 处 理 程 序 方 法 。 


private void Formi Load(object sender, System.EventArgs e) 


// Add your form load event handling code here. 


还 会 在 项 目的 Form1.Designer.cs 文件 的 InitializeComponent 方法 中 自动 生成 
订阅 该 事件 所 需 的 代码 行 。 该 代码 行 类 似 于 : 


this.Load += new System.EventHandler(this.Formi Load); 


以 编程 方式 订阅 事件 


1. 定义 一 个 事件 处 理 程序 方法 ， 其 签名 与 该 事件 的 委托 签名 匹配 。 例 如 ， 如 果 事 
件 基 于 EventHandler 委托 类 型 ， 则 下 面 的 代码 表示 方法 存根 : 


void HandleCustomEvent(object sender, CustomEventArgs a) 


// Do something useful here. 


2. 使 用 加 法 赋值 运算 符 (+=) 来 为 事件 附加 事件 处 理 程序 。 在 下 面 的 示例 中 ， 假 设 
名 为 publisher 的 对 象 拥有 一 个 名 为 RaiseCustomEvent 的 事件 。 请 注意 ， 订 
户 类 需要 引用 发 行者 类 才能 订阅 其 事件 。 


publisher.RaiseCustomEvent += HandleCustomEvent; 


请 注意 ， 前 面 的 语法 是 CH 2.0 中 的 新 语法 。 此 语法 完全 等 效 于 必须 使 用 new 
关键 字 显 式 创建 封装 委托 的 C# 1.0 语法 : 


publisher.RaiseCustomEvent += new CustomEventHandler(HandleCust 


‘| 








public Formi() 


{ 
InitializeComponent(); 
// Use a lambda expression to define an event handler. 
this.Click += (s,e) -&gt; { MessageBox.Show( 
((MouseEventArgs)e).Location.ToString());); 
} 


有 关 更 多 信息 ， 请 参见 如 何 : f£ LINQ 外 部 使 用 Lambda 表达 式 (CH 编程 指 
南 ) 。 


使 用 匿名 方法 订阅 事件 


e 如 果 以 后 不 必 取 消 订 阅 某 个 事件 ， 则 可 以 使 用 加 法 赋值 运算 符 (+=) 将 匿名 方法 
附加 到 此 事件 。 在 下 面 的 示例 中 ， 假 设 名 为 publisher 的 对 象 拥有 一 个 名 为 
RaiseCustomEvent 的 事件 ， 并 且 还 不 定义 了 一 个 CustomEventArgs 类 以 承载 
a 类 型 的 专用 事件 信息 。 请 注意 ， 订 户 类 需要 引用 publisher 才能 订阅 其 事 


publisher.RaiseCustomEvent += delegate(object o, CustomEventArc 


{ 
string s = o-ToString() + " " + e.ToString(); 
Console.WriteLine(s); 


H 





HI S, MRRAB AWM Sst, SMD Ai Di ERE RAM, 
这 种 情况 下 若 要 取消 订阅 ， 必 须 返 回 到 该 事件 的 订阅 代码 ， 将 该 匿名 方法 存储 
在 委托 变量 中 ， 然 后 将 此 委托 添加 到 该 事件 中 。 一 般 来 说， 如 果 必 须 在 后 面 的 
Donum 则 建议 您 不 要 使 用 匿名 函数 订阅 此 事件 。 有 关 匿 名 
函数 的 更 多 信息 ， 请 参见 匿名 函数 (CH 编程 指南 ) o 


取消 订阅 


要 防止 在 引发 事件 时 调用 事件 处 理 程序 ， 请 取消 订阅 该 事件 。 要 防止 资源 泄露 ， 应 
在 释放 订户 对 象 之 前 取消 订阅 事件 。 在 取消 订阅 事件 之 前 ， 在 发 布 对 象 中 作为 该 事 
件 的 基础 的 多 路 广播 委托 会 引用 封装 了 订户 的 事件 处 理 程序 的 委托 。 只 要 发 布 对 象 
保持 该 引用 ， 垃 圾 回收 功能 就 不 会 删除 订户 对 象 。 
取消 订阅 事件 

e 使 用 减法 赋值 运算 符 (-=) 取消 订阅 事件 : 


publisher.RaiseCustomEvent -= HandleCustomEvent; 
所 有 订户 都 取消 订阅 事件 后 ， 发 行者 类 中 的 事件 实例 将 设置 为 null。 


请 参阅 

事件 (CH 编程 指南 ) 

event (C# 参考 ) 

如 何 : 发 布 符合 .NET Framework 准则 的 事件 (CH 编程 指南 ) 
-= 运算 符 (C# 参考 ) 

+= 运算 符 (CH 参考 ) 


如 何 : 发 布 符合 .NET Framework 准则 的 事件 
(CH 编程 指南 ) 
下 面 的 过 程 演示 了 如 何 将 符合 标准 NET Framework 模式 的 事件 添加 到 您 的 类 和 结 


构 中 。.NET Framework 类 库 中 的 所 有 事件 均 基于 EventHandler 委托 ， 定 义 如 
F: 


public delegate void EventHandler(object sender, EventArgs e); 


o o 
Ef TER 


.NET Framework 2.0 引入 了 此 委托 的 一 个 泛 型 版 本 ， 即 
EventHandler<TEventArgs>。 下 面 的 示例 显示 如 何 使 用 这 两 种 版 本 。 


虽然 您 定义 的 类 中 的 事件 可 基于 任何 有 效 委 托 类 型 (甚至 是 可 返回 值 的 委托 ) ， 但 
是 ， 通 常 建议 您 使 用 EventHandler 让 事件 基于 .NET Framework 模式 ， 如 下 面 的 
示例 所 示 。 


采用 EventHandler 模式 发 布 事件 


1.，《〈 如 果 不 需 要 与 事件 一 起 发 送 自 定 义 数 据 ， 请 跳 过 此 步 又， 进入 步骤 3a. ) 在 
发 行者 类 和 订阅 方 类 均 可 看 见 的 范围 中 声明 自 定义 数据 的 类 。 然 后 添加 保留 您 
的 自 定义 事件 数据 所 需 的 成 员 。 在 此 示例 中 ， 会 返回 一 个 简单 字符 串 。 


public class CustomEventArgs : EventArgs 
public CustomEventArgs(string s) 
msg - s; 
private string msg; 


public string Message 


| 


get ( return msg; ) 


2. (如果 您 使 用 的 是 EventHandler<TEventArgs> 的 泛 型 版 本 ， 请 跳 过 此 步 
又 。) 在 发 布 类 中 声明 一 个 委托 。 为 它 指定 以 EventHandler 结尾 的 名 称 。 第 
二 个 参数 指定 自 定义 EventArgs 类 型 。 


public delegate void CustomEventHandler(object sender, CustomEv 


‘| 











3. 使 用 以 下 任 一 步骤 ， 在 发 布 类 中 声明 事件 。 
i. p E EventArgs 类 ， 事 件 类 型 就 是 非 泛 型 EventHandler Æ 


托 。 无 需 声 明 委 托 ， 因 为 它 已 在 创建 C# 项 目 时 包含 的 System 命名 空间 
中 进 行 了 表明 : 将 以 下 代码 添加 到 发 行者 类 中 。 


public event EventHandler RaiseCustomEvent; 


ii， 如 果 使 用 的 是 EventHandler 的 非 泛 型 版 本 ， 并 且 您 有 一 个 由 EventArgs 


派生 的 自 定义 类 ， 请 在 发 布 类 中 声明 您 的 事件 ， 并 且 将 来 自 步 又 2 的 委托 
用 作 类 型 。 


public event CustomEventHandler RaiseCustomEvent; 


如 果 使 用 的 是 泛 型 版 本 ， 则 不 需要 自 定义 委托 。 相 反 ， 在 发 行者 类 中 ， 您 
应 将 事件 类 型 指定 为 EventHandler<CustomEventArgs>， 将 尖 括 号 中 的 
内 容 蔡 换 为 自己 的 类 的 名 称 。 


public event EventHandler&lt;CustomEventArgs&gt; RaiseCusto 
E —— 





下 面 的 示例 通过 将 自 定义 EventArgs 类 和 EventHandler<TEventArgs> 用 作 事 件 类 
型 来 演示 上 述 步骤 。 


namespace DotNetEvents 


{ 


using System; 
using System.Collections.Generic; 


// Define a class to hold custom event info 
public class CustomEventArgs : EventArgs 


( 


public CustomEventArgs(string s) 


{ 
} 


private string message; 


message = S, 


public string Message 


{ 
get { return message; } 
set { message = value; } 


} 


// Class that publishes an event 
class Publisher 


( 


j 


// Declare the event using EventHandler<T> 
public event EventHandler<CustomEventArgs> RaiseCustomEvent 


public void DoSomething() 


{ 
// Write some code that does something useful here 
// then raise the event. You can also raise an event 
// before you execute a block of code. 
OnRaiseCustomEvent (new CustomEventArgs("Did something": 
} 


// Wrap event invocations inside a protected virtual methot 
// to allow derived classes to override the event invocati 
protected virtual void OnRaiseCustomEvent(CustomEventArgs t 
{ 
// Make a temporary copy of the event to avoid possibi- 
// a race condition if the last subscriber unsubscribe: 
// immediately after the null check and before the ever 
EventHandler<CustomEventArgs> handler = RaiseCustomEver 


// Event will be null if there are no subscribers 
if (handler != null) 


{ 
// Format the string to send inside the CustomEveni 
e.Message += String.Format(" at {0}", DateTime .Now 
// Use the () operator to raise the event. 
handler(this, e); 

} 


//Class that subscribes to an event 
class Subscriber 


i 


private string id; 
public Subscriber(string ID, Publisher pub) 


f 
id - ID; 
// Subscribe to the event using C£ 2.0 syntax 
pub.RaiseCustomEvent += HandleCustomEvent; 

} 


// Define what actions to take when the event is raised. 
void HandleCustomEvent(object sender, CustomEventArgs e) 


Console.WriteLine(id + " received this message: {0}", « 


static void Main(string[] args) 


Publisher pub - 
Subscriber subi 
Subscriber sub2 


new Publisher(); 


new Subscriber("sub1", pub); 
new Subscriber("sub2", pub); 


// Call the method that raises the event. 


pub.DoSomething(); 


// Keep the console window open 
Console.WriteLine("Press Enter to close this window."), 
Console.ReadLine(); 


} 
} 
class Program 
{ 
{ 
} 
} 
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如 何 : 在 派生 类 中 引发 基 类 事件 (CH 编程 指南 ) 


以 下 简单 示例 演示 了 在 基 类 中 声明 可 从 派生 类 引发 的 事件 的 标准 方法 。 此 模式 广泛 
应 用 于 .NET Framework 类 库 中 的 Windows 窗 体 类 。 


在 创建 可 用 作 其 他 类 的 基 类 的 类 时 ， 应 考虑 如 下 事实 : 事件 是 特殊 类 型 的 委托 ， 只 
可 以 从 声明 它们 的 类 中 调用 。 派 生 类 无 法 直接 调用 基 类 中 声明 的 事件 。 尽 管 有 时 需 
要 事件 仅 由 基 类 引发 ， 但 在 大 多 数 情形 下 ， 应 该 允许 派生 类 调用 基 类 事件 。 为 此 ， 
您 可 以 在 包含 该 事件 的 基 类 中 创建 一 个 受 保 折 的 调用 方法 。 通 过 调用 或 重 写 此 调用 
方法 ， 派 生 类 便 可 以 间接 调用 该 事件 。 


== 
Ef TERR 


不 要 在 基 类 中 声明 虚拟 事件 ， 也 不 要 在 派生 类 中 重 写 这 些 事件 。 C# 编译 器 无 法 
正确 处 理 这 些 事件 ， 并 且 无 法 预知 的 该 派生 的 事件 的 用 户 是 否 真 正 订阅 了 基 类 
事件 。 


namespace BaseClassEvents 


{ 
using System; 
using System.Collections.Generic; 


// Special EventArgs class to hold info about Shapes. 
public class ShapeEventArgs : EventArgs 


( 


private double newArea; 
public ShapeEventArgs(double d) 
{ 


newArea = d; 


public double NewArea 


{ 
j 


get { return newArea; } 


j 


// Base class event publisher 
public abstract class Shape 


{ 


protected double area; 


public double Area 
{ 


get { return area; } 
set { area = value; } 


// The event. Note that by using the generic EventHandler< 
// we do not need to declare a separate delegate type. 
public event EventHandler«ShapeEventArgs» ShapeChanged; 


public abstract void Draw(); 


//The event-invoking method that derived classes can overr: 

protected virtual void OnShapeChanged(ShapeEventArgs e) 

t 
// Make a temporary copy of the event to avoid possibi- 
// a race condition if the last subscriber unsubscribe: 
// immediately after the null check and before the ever 
EventHandler«ShapeEventArgs» handler - ShapeChanged; 
if (handler !- null) 


handler(this, e); 


} 
} 
} 
public class Circle : Shape 
{ 
private double radius; 
public Circle(double d) 
{ 
radius = d; 
area = 3.14 * radius * radius; 
} 
public void Update(double d) 
{ 
radius = d; 
area = 3.14 * radius * radius; 
OnShapeChanged(new ShapeEventArgs(area)); 
} 
protected override void OnShapeChanged(ShapeEventArgs e) 
{ 
// Do any circle-specific processing here. 
// Call the base class event invocation method. 
base.OnShapeChanged(e); 
j 
public override void Draw() 
{ 
Console.WriteLine("Drawing a circle"); 
j 
} 


public class Rectangle : Shape 
{ 
private double length; 
private double width; 
public Rectangle(double length, double width) 


{ 


this.length - length; 
this.width - width; 
area - length * width; 


} 
public void Update(double length, double width) 
{ 

this.length = length; 

this.width - width; 

area - length * width; 

OnShapeChanged(new ShapeEventArgs(area)); 


} 
protected override void OnShapeChanged(ShapeEventArgs e) 


( 


// Do any rectangle-specific processing here. 


// Call the base class event invocation method. 
base.OnShapeChanged(e); 


j 
public override void Draw() 
{ 
Console.WriteLine("Drawing a rectangle"); 
j 


j 


// Represents the surface on which the shapes are drawn 
// Subscribes to shape events so that it knows 

// when to redraw a shape. 

public class ShapeContainer 


{ 
List<Shape> _list; 


public ShapeContainer() 


{ 
_list = new List<Shape>(); 
} 
public void AddShape(Shape s) 
{ 
_list.Add(s); 
// Subscribe to the base class event. 
s.ShapeChanged += HandleShapeChanged; 
} 
// ...Other methods to draw, resize, etc. 


private void HandleShapeChanged(object sender, ShapeEventAt 


{ 
Shape s = (Shape)sender; 


// Diagnostic message for demonstration purposes. 
Console.WriteLine("Received event. Shape area is now {( 


// Redraw the shape here. 
s.Draw(); 


j 


class Test 


( 


static void Main(string[] args) 

1 
//Create the event publishers and subscriber 
Circle c1 - new Circle(54); 
Rectangle r1 - new Rectangle(12, 9); 
ShapeContainer sc - new ShapeContainer(); 


// Add the shapes to the container. 
sc.AddShape(c1); 
sc.AddShape(r1); 


// Cause some events to be raised. 
c1.Update(57); 
ri.Update(7, 7); 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


j 


/* Output: 
Received event. Shape area is now 10201.86 
Drawing a circle 
Received event. Shape area is now 49 
Drawing a rectangle 
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访问 修饰 符 (CH 编程 指南 ) 

在 Windows 窗 体 中 创建 事件 处 理 程序 


如 何 : 实现 接口 事件 (CH 编程 指 两 ) 


接口 可 声明 事件 。 下 面 的 示例 演示 如 何在 类 中 实现 接口 事件 。 实 现 接口 事件 的 规则 
与 实现 任何 接口 方法 或 属性 的 规则 基本 相同 。 


在 类 中 实现 接口 事件 
。 在 类 中 声明 事件 ， 然 后 在 适当 的 区 域 调用 该 事件 。 


namespace ImplementInterfaceEvents 


i public interface IDrawingObject 
i event EventHandler ShapeChanged; 
use class MyEventArgs : EventArgs 
// class members 
T class Shape : IDrawingObject 
; public event EventHandler ShapeChanged; 
void ChangeShape() 
// Do something here before the event.. 
OnShapeChanged(new MyEventArgs(/*arguments*/)); 
// or do something here after the event. 
protected virtual void OnShapeChanged(MyEventArgs e) 
if(ShapeChanged !- null) 
ShapeChanged(this, e); 
j 
j 
j 
j 


BBY AN DU A A AL RAR SS Uo: 您 的 类 是 从 两 个 以 上 的 接口 继承 的 ， 
每 个 接口 都 含有 同名 事件 ) 。 在 这 种 情况 下 ， 您 至 少 要 为 其 中 一 个 事件 提供 显 式 接 
口 实现 。 为 事件 编写 显 式 接口 实现 时 ， 必 须 编写 add 和 remove 事件 访问 器 。 这 
两 个 事件 访问 器 通常 由 编译 器 提供 ， 但 在 这 种 情况 下 编译 器 不 能 提供 。 


您 可 以 提供 自己 的 访问 器 ， 以 便 指 定 这 两 个 事件 是 由 您 的 类 中 的 同一 事件 表示 ， 还 
是 由 不 同事 件 表 示 。 例 如 ， 根 据 接口 规范 ， 如 果 事 件 应 在 不 同时 间 引 发 ， 则 可 以 将 
每 个 事件 与 类 中 的 一 个 单独 实现 关联 。 在 下 面 的 示例 中 ， 订 户 将 形状 引用 强制 转换 
为 IShape 或 IDrawingObject， 从 而 确定 自己 将 会 接收 哪个 OnDraw 事件 。 


namespace WrapTwoInterfaceEvents 


( 


using System; 


public interface IDrawingObject 


( 


// Raise this event before drawing 
// the object. 
event EventHandler OnDraw; 


public interface IShape 


{ 
// Raise this event after drawing 
// the shape. 
event EventHandler OnDraw; 

j 


// Base class event publisher inherits two 

// interfaces, each with an OnDraw event 

public class Shape : IDrawingObject, IShape 

if 
// Create an event for each interface event 
event EventHandler PreDrawEvent; 
event EventHandler PostDrawEvent; 


object objectLock = new Object(); 


// Explicit interface implementation required. 
// Associate IDrawingObject's event with 

// PreDrawEvent 

event EventHandler IDrawingObject.OnDraw 


{ 
add 
lock (objectLock) 
{ 
PreDrawEvent += value; 
} 
} 
remove 
lock (objectLock) 
{ 
PreDrawEvent -= value; 
} 
} 


// Explicit interface implementation required. 
// Associate IShape's event with 

// PostDrawEvent 

event EventHandler IShape.OnDraw 


{ 
add 
lock (objectLock) 
{ 
PostDrawEvent += value; 
} 
} 
remove 
lock (objectLock) 
{ 
PostDrawEvent -= value; 
} 
} 
} 


// For the sake of simplicity this one method 

// implements both interfaces. 

public void Draw() 

{ 
// Raise IDrawingObject's event before the object is di 
EventHandler handler - PreDrawEvent; 
if (handler !- null) 


handler(this, new EventArgs()); 
j 


Console.WriteLine("Drawing a shape."); 


// RaiseIShape's event after the object is drawn. 
handler - PostDrawEvent; 
if (handler !- null) 


handler(this, new EventArgs()); 


j 


public class Subscriber1 


( 


// References the shape object as an IDrawingObject 
public Subscriberi(Shape shape) 


{ 
IDrawingObject d = (IDrawingObject)shape; 
d.OnDraw += new EventHandler(d OnDraw); 


j 


void d OnDraw(object sender, EventArgs e) 


( 


Console.WriteLine("Subi receives the IDrawingObject eve 
j 
} 


// References the shape object as an IShape 
public class Subscriber2 


{ 
public Subscriber2(Shape shape) 
{ 
IShape d = (IShape)shape; 
d.OnDraw += new EventHandler(d OnDraw); 
} 
void d_OnDraw(object sender, EventArgs e) 
{ 
Console.WriteLine("Sub2 receives the IShape event."); 
} 
} 
public class Program 
{ 
static void Main(string[] args) 
{ 
Shape shape = new Shape(); 
Subscriber1 sub = new Subscriber1(shape); 
Subscriber2 sub2 = new Subscriber2(shape); 
shape.Draw(); 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
} 
/* Output: 
Sub1 receives the IDrawingObject event. 
Drawing a shape. 
Sub2 receives the IShape event. 
“7 
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如 何 : 在 派生 类 中 引发 基 类 事件 (CH 编程 指南 ) 


如 何 : 实现 接口 事件 (CH 编程 指南 ) 179 


如 何 : 使 用 字典 存储 事件 实例 (CH 编程 指 两 ) 


accessor-declarations 的 一 种 用 法 是 公开 很 多 事件 但 不 为 每 个 事件 分 配 字 段 ， 而 
是 使 用 字典 来 存储 这 些 事件 实例 。 这 只 在 具有 很 多 事件 但 您 预计 大 多 数 事件 都 不 会 
实现 时 才 有 用 。 


public delegate void EventHandleri(int i); 
public delegate void EventHandler2(string s); 


public class PropertyEventsSample 


{ 


private System.Collections.Generic.Dictionary<string, System. De 


public PropertyEventsSample() 


{ 
eventTable = new System.Collections.Generic.Dictionary<str: 
eventTable.Add("Eventi", null); 
eventTable.Add("Event2", null); 
j 
public event EventHandleri Eventi 
{ 
add 
lock (eventTable) 
{ 
eventTable["Eventi"] = (EventHandleri)eventTable["t 
j 
j 
remove 
lock (eventTable) 
{ 
eventTable["Eventi"] = (EventHandleri)eventTable["t 
j 
j 
j 
public event EventHandler2 Event2 
{ 
add 
lock (eventTable) 
{ 
eventTable["Event2"] = (EventHandler2)eventTable["t 
} 
} 
remove 


{ 


j 


lock (eventTable) 


{ 
eventTable["Event2"] = (EventHandler2)eventTable["t 
j 
j 
j 
internal void RaiseEventi(int i) 
{ 
EventHandleri handler1; 
if (null != (handleri = (EventHandleri)eventTable["Eventi"' 
handleri(i); 
j 
j 


internal void RaiseEvent2(string s) 


EventHandler2 handler2; 
if (null != (handler2 = (EventHandler2)eventTable["Event2"' 


handler2(s); 


public class TestClass 


{ 


public static void DelegateiMethod(int i) 


{ 
System.Console.WriteLine(i); 
j 
public static void Delegate2Method(string s) 
{ 
System.Console.WriteLine(s); 
j 
static void Main() 
{ 


PropertyEventsSample p = new PropertyEventsSample(); 


.Event1 += new EventHandleri(TestClass.DelegateiMethod); 
.Event1 += new EventHandleri(TestClass.DelegateiMethod); 
.Event1 -= new EventHandleri(TestClass.DelegateiMethod); 
.RaiseEvent1(2); 


TTT TD 


.Event2 += new EventHandler2(TestClass.Delegate2Method); 
.Event2 += new EventHandler2(TestClass.Delegate2Method); 
.Event2 -- new EventHandler2(TestClass.Delegate2Method); 
.RaiseEvent2("TestString"); 


TTT TD 


// Keep the console window open in debug mode. 


System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


} 


} 

/* Output: 
2 
TestString 





到 





请 参阅 
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如 何 : 实现 目 定 义 事件 访问 器 (CH 编程 指南 ) 


事件 是 特殊 类 型 的 多 路 广播 委托 ， 只 能 从 声明 它 的 类 中 调用 。 客 户 端 代码 通过 提供 
对 应 在 引发 事件 时 调用 的 方法 的 引用 来 订阅 事件 。 这 些 方法 通过 事件 访问 器 添加 到 
委托 的 调用 列表 中 ， 事 件 访问 器 类 似 于 属性 访问 器 ， 不 同 之 处 在 于 事件 访问 器 被 命 
名 为 add 和 remove。 人 在 大 多 数 情 况 下 都 不 需要 提供 自 定 义 的 事件 访问 器 。 如 果 您 
在 代码 中 没有 提供 自 定义 的 事件 访问 器 ， 编 译 器 会 自动 添加 事件 访问 器 。 但 在 某 些 
情况 下 ， 您 可 能 需要 提供 自 定义 行为 。 在 主题 如 何 : 实现 接口 事件 (CH 编程 指 
南 ) 中 就 演示 了 这 样 一 种 情况 。 

下 面 的 示例 演示 如 何 实现 自 定 义 的 add 和 remove 事件 访问 器 。 虽 然 可 以 替换 这 些 


访问 器 内 的 任何 代码 ， 但 建议 您 在 添加 或 移 除 新 的 事件 处 理 程 序 方法 之 前 先 锁定 该 
事件 。 


event EventHandler IDrawingObject.OnDraw 
add 
lock (PreDrawEvent) 


PreDrawEvent += value; 


} 
remove 
lock (PreDrawEvent) 
{ 
PreDrawEvent -= value; 
} 
} 


请 参阅 
事件 (CH 编程 指南 ) 
event (C£ 参考 ) 


FA ee (CH 编程 指南) 


C# 语言 的 异常 处理 功能 可 帮助 您 处 理 程 序 运 行 时 出 现 的 任何 意外 或 异常 情况 。 昼 
常 处 理 使 用 try, catch 和 finally 关键 字 尝试 某 些 操作 ， 以 处 理 失败 情况 ， 尽 管 这 
些 操 作 有 可 能 失败 ， 但 如 果 您 确定 需要 这 样 做 ， 且 希望 在 事后 清理 资源 ， 就 可 以 党 
试 这样 做 。 公 共 语 言 运行 时 (CLR) .NET Framework 或 任何 第 三 方 库 或 者 应 用 程 
序 代码 都 可 以 生成 异常 。 异 常 是 使 用 throw 关键 字 创建 的 。 


很 多 情况 下 ， 异 常 可 能 不 是 由 代码 直接 调用 的 方法 引发 ， 而 是 由 调用 堆栈 中 位 置 更 
靠 下 的 另 一 个 方法 所 引发 。 在 这 种 情况 下 ，CLR 将 展开 堆栈 ， 查 找 是 否 有 方法 包含 
针对 该 特定 异常 类 型 的 catch 块 ， 如 果 找 到 这 样 的 方法 ， 就 会 执行 找到 的 第 一 个 这 
样 的 catch 块 。 如 果 在 调用 堆栈 中 的 任何 位 置 都 没有 找到 适当 的 catch 块 ， 就 会 终 
止 该 进程 ， 并 向 用 户 显 示 一 条 消息 。 


此 示例 中 使 用 一 个 方法 检测 是 否 有 被 雳 除 的 情况 ; 如 果 有 ， 则 捕获 该 错误 。 如 果 没 
异常 处 理 ， 此 程序 将 终止 并 产生 “DivideByZeroException 未 义理 ”错误 。 


class ExceptionTest 


( 


static double SafeDivision(double x, double y) 


if (y == 0) 
throw new System.DivideByZeroException(); 
return x / y; 


static void Main() 
{ 
// Input for test purposes. Change the values to see 
// exception handling behavior. 
double a = 98, b = 0; 
double result = 0; 


try 
{ 
result = SafeDivision(a, b); 
Console.WriteLine("{0} divided by {1} = {2}", a, b, re: 


catch (DivideByZeroException e) 


{ 


Console.WriteLine("Attempted divide by zero."); 





Ha 
Ba 


具有 以 下 特点 : 
各 种 类 型 的 异常 最 终 都 是 由 System.Exception 派生 而 来 。 
在 可 能 引发 异常 的 语句 周围 使 用 try 块 。 


—H try 块 中 发 生 异 常 ， 控 制 流 将 跳 转 到 第 一 个 关联 的 异常 处 理 程序 (无论 该 
处 理 程 序 存在 于 调用 堆栈 中 的 什么 位 置 ) 。 在 C# 中 ，catch 关键 字 用 于 定义 
异常 处 理 程序 。 


如 果 给 定 异常 没有 异常 处 理 程 序 ， 则 程序 将 停止 执行 ， 并 显示 一 条 错误 消息 。 
除非 您 可 以 处 理 某 个 异常 并 使 应 用 程序 处 于 已 知 状态 。 否 则 请 不 要 捕捉 该 异 
常 。 如 果 捕 捉 System.Exception， 请 在 catch 块 的 末尾 使 用 throw 关键 字 再 
次 引发 该 异常 。 

如 果 catch 块 定义 了 一 个 异常 变量 ， 则 可 以 用 它 获 取 有 关 所 发 生 有 异常 类 型 的 更 
多 信息 。 

程序 可 以 使 用 throw 关键 字 显 式 地 引发 异常 。 

异常 对 象 包 含有 关 错 误 的 详细 信息 ， 比 如 调用 堆栈 的 状态 以 及 有 关 错 误 的 文本 
说 明 。 

即使 发 生 异 常 也 会 执行 finally 块 中 的 代码 。 使 用 finally 块 释放 资源 ， 例 如 ， 
关闭 在 try 块 中 打开 的 任何 流 或 文件 。 


.NET Framework 中 的 托管 异常 是 凭借 Win32 结构 化 异常 处理 机 制 实现 的 。 有 
关 更 多 信息 ， 请 参见 结构 化 异常 处理 (C/C++) 和 A Crash Course on the 
Depths of Win32 Structured Exception Handling (有 关 深 入 探究 Win32 结构 
化 异常 处 理 的 应 急 课程 ) 。 


相关 章节 


有 关 异 常 和 异常 处 理 的 更 多 信息 ， 请 参见 以 下 主题 : 


使 用 异常 (CH 编程 指南 ) 

异常 处 理 (C# 编程 指南 ) 

创建 和 引发 异常 (CH 编程 指南 ) 
编译 器 生成 的 异常 (CH 编程 指南 ) 

如 何 : 使 用 try/catch 人 处理 异常 (CH 编程 指南 ) 
如 何 : 使 用 finally 执行 清理 代码 (C# 编程 指南 ) 


CH 32 BASE 


有 关 详 细 信 息 ， 请 参阅 C#iSSM5C. BiB Mee CH 语法 和 用 法 的 权威 资料 。 
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请 参阅 
SystemException 
C# 编程 指南 
CHART 
throw (C£ 参考 ) 
try-catch (C# 参考 ) 
try-finally (C# 参考 ) 
try-catch-finally (C£ 参考 ) 
处 理 和 引发 异常 
异常 层次 结构 
编写 可 靠 的 .NET 代码 
定 


特定 异常 的 Minidumps 


异常 和 异常 处 理 (C# 编程 指南 ) 
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使 用 异常 (CH 编程 指南 ) 


在 CH 中 ， 程 序 中 的 运行 时 错误 通过 使 用 一 种 称 为 “异常 "的 机 制 在 程序 中 传播 。 OF 
常 由 遇 到 错误 的 代码 引发 ， 由 能 够 更 正 错误 的 代码 捕捉 。 异常 可 由 NET 
Framework 公共 语言 运行 时 (CLR) 或 由 程序 中 的 代码 引发 。 一 旦 引发 了 一 个 异 
常 ， 这 个 异常 就 会 在 调用 堆栈 中 往 上 传播 ， 直 到 找到 针对 它 的 catch 语句 。 未 捕获 
的 异常 由 系统 提供 的 通用 异常 处 理 程序 处 理 ， 该 处 理 程序 会 显示 一 个 对 话 框 。 


异常 由 从 Exception 派生 的 类 表示 。 此 类 标识 异常 的 类 型 ， 并 包含 详细 描述 异常 的 


属性 。 引发 异常 涉及 到 创建 一 个 异常 派生 类 的 实例 ， 配 置 异 常 的 属性 (可 选 ) ， 然 
后 使 用 throw 关键 字 引 发 该 对 象 。 例如 : 


class CustomException : Exception 


{ 
public CustomException(string message) 
{ 
} 
} 
private static void TestThrow() 
{ 
CustomException ex = 
new CustomException("Custom exception in TestThrow()"); 
throw ex; 
j 


在 引发 异常 之 后 ， 运 行 时 检查 当前 语句 以 确定 它 是 否 在 try 块 中 。 如 果 是 ， 则 检查 
与 该 try 块 关 联 的 任何 catch 块 ， 以 确定 它们 是 否 能 够 捕获 该 异常 。 Catch 块 通常 
会 指定 异常 类 型 ; 如 果 该 catch 块 的 类 型 与 异常 或 异常 的 基 类 的 类 型 相同 ， 则 该 
catch 块 就 能 够 处 理 该 方法 。 例如 : 


static void TestCatch() 
t 


try 
TestThrow(); 


catch (CustomException ex) 


{ 
} 


System.Console.WriteLine(ex.ToString()); 


如 果 引 发 异常 的 语句 不 在 try 块 中 ， 或 者 包含 该 语句 的 try 块 没有 匹配 的 catch 3, 
运行 时 将 检查 调用 方法 中 是 否 有 try 语句 和 catch 块 。 运行 时 将 在 调用 堆栈 中 向 上 
继续 搜索 兼容 的 catch 块 。 在 找到 并 执行 catch 块 之 后 ， 控 制 权 将 传递 给 catch 块 
之 后 的 下 一 个 语句 。 

— try 语句 可 能 包含 多 个 catch 块 。 将 执行 第 一 个 能 够 处 理 该 异常 的 catch 语 
A ; 任何 后 续 的 catch 语句 都 将 被 忽略 ， 即 使 它们 是 兼容 的 也 如 此 。 因此 ， 在 任何 
Ne de ype rarer een ieee 
块 。 例如 : 


static void TestCatch2() 


{ 

System.IO.StreamWriter sw = null; 

try 

{ 
sw = new System.10.StreamWriter(@"C:\test\test.txt"); 
sw.WriteLine("Hello"); 

j 

catch (System.IO.FileNotFoundException ex) 
// Put the more specific exception first. 
System.Console.WriteLine(ex.ToString()); 

j 

catch (System.IO.IOException ex) 
// Put the less specific exception last. 
System.Console.WriteLine(ex.ToString()); 

} 

finally 
sw.Close(); 

} 

System.Console.WriteLine("Done"); 

j 


执行 catch 块 之 前 ， 运 行 时 会 检查 finally 3&, Finally 块 使 程序 员 能 够 清除 中 止 的 
try 块 可 能 遗留 下 的 任何 模糊 状态 ， 或 者 释放 任何 外 部 资源 CIMA, Wie 
连接 或 文件 流 ) ， 而 无 需 等 待 运行 时 中 的 垃圾 回收 器 终结 这 些 对 象 。 例如 : 


static void TestFinally() 

{ 
System.IO.FileStream file = null; 
//Change the path to something that works on your machine. 
System.IO.FileInfo fileInfo = new System.IO.FileInfo(Q"C:Nfile 
try 


file = fileInfo.Openwrite(); 
file.writeByte(OXF); 


} 
finally 


// Closing the file allows you to reopen it immediately - « 
if (file !- null) 


file.Close(); 


j 


try 
t 
file = fileInfo.Openwrite(); 
System.Console.WriteLine("Openwrite() succeeded"); 
catch (System.1I0. IOException) 


System.Console.WriteLine("Openwrite() failed"); 





如 果 WriteByte() 引发 了 异常 ， 那 么 在 没有 调用 file.Close() 的 情况 下 ， 第 二 个 try 
块 中 尝试 重 新 打开 文件 的 代码 就 会 失败 ， 并 且 文 件 将 保持 锁定 状态 。 由 于 要 执行 
finally 块 〈 即 使 已 引发 异常 ) ， 前 一 示例 中 的 finally 块 使 得 可 以 正确 地 关闭 文件 ， 
从 而 帮助 避免 错误 。 


如 果 在 引发 异常 之 后 没有 在 调用 堆栈 上 找到 兼容 的 catch 块 ， 则 会 出 现 三 种 情况 中 
的 一 种 : 


° A a A KA, mE TARAH AER (如 果 


e DIS FHIÉEJS IR BR AGAS ERAS SFREE, RISE — 
TypelnitializationException， 并 将 原始 异常 分 配给 新 异常 的 deci 
性 。 


e 如 果 到 达 线 程 的 开头 ， 则 终止 线程 。 
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异常 处 理 (C# 编程 指责) 


CH 程序 员 可 使 用 try 块 对 可 能 受 异常 影响 的 代码 进行 分 区 。 关 联 的 catch RAFR 
理 任 何 结果 异常 。 一 个 包含 代码 的 finally 块 ， 无 论 try 块 中 是 否 引 发 异常 〈 例 如 ， 
释放 在 try 块 中 分 配 的 资源 ) ， 这 些 代码 都 会 运行 。 一 个 try 块 需要 一 个 或 多 个 关 
联 的 catch 块 或 一 个 finally 块 ， 或 两 者 。 


以 下 示例 给 出 了 一 个 try-catch 语句 ， 一 个 try-finally 语句 ， 和 一 个 try-catch- 
finally 语句 。 


try 
// Code to try goes here. 
catch (SomeSpecificException ex) 
// Code to handle the exception goes here. 
// Only catch exceptions that you know how to handle. 


// Never catch base class System.Exception without 
// rethrowing it at the end of the catch block. 


try 
// Code to try goes here. 
} 
finally 


// Code to execute after the try block goes here. 


try 
// Code to try goes here. 
catch (SomeSpecificException ex) 
// Code to handle the exception goes here. 
rents 
// Code to execute after the try (and possibly catch) blocks 
// goes here. 
国定 一 = 
不 带 有 catch 或 finally 块 的 try 块 将 导致 编译 器 错误 。 


Catch 块 


catch 块 可 以 指定 要 捕捉 的 异常 的 该 类 型 。 类 型 规范 称 为 “异常 第 选 器 "。 异 常 类 型 
应 从 Exception 派生 出 来 。 一 般 而 言 ， 不 会 将 Exception 指定 为 异常 得 选 器 ， 除 非 
您 了 解 如 何 处 理 try 块 中 可 能 引发 的 所 有 异常 ， 或 者 您 在 catch 块 中 包括 了 throw 
语句 。 


具有 不 同 异 常 筛选 器 的 多 个 catch 块 可 以 串联 在 一 起 。 多 个 catch 数据 块 的 计算 顺 
序 是 在 代码 中 从 顶部 到 底部 ， 但 是 ， 对 于 所 引发 的 每 个 异常 ， 都 只 执行 一 个 catch 
数据 块 。 与 指定 的 准确 类 型 或 其 基 类 最 为 匹配 的 第 一 个 catch 块 被 执行 。 如 果 
catch 块 没有 指定 匹配 异常 筛选 器 ， 则 catch 块 就 不 具有 选 定 的 筛选 器 (如 果 语 句 
有 的 话 ) 。 需 要 将 带 有 最 具体 的 ( 即 派生 程度 最 高 的 ) 异常 类 的 catch 块 放 在 最 前 
面 。 


当下 列 条 件 为 真 时 ， 应 该 捕捉 异常 : 


e 对 引发 异常 的 原因 有 具体 的 了 解 ， 并 可 实现 特定 的 恢复 ， 例 如 ， 在 捕获 
FileNotFoundException 对 象 时 提示 用 户 输 入 新 的 文件 名 。 


e 可 以 新 建 一 个 更 具体 的 异常 并 引发 该 异常 。 


int GetInt(int[] array, int index) 


{ 
try 
{ 
return array[index]; 
catch(System.IndexOutOfRangeException e) 
throw new System.ArgumentOutOfRangeException( 
"Parameter index is out of range."); 
} 
} 


e 希望 在 将 异常 传递 出 去 进行 额外 处 理 前 部 分 地 人 处理 异 常 。 在 下 面 的 示例 
中 ，catch 块 用 于 在 再 次 引发 异常 之 前 ， 向 错误 日 志 添 加 条 目 。 
try 
// Try to access a resource. 


catch (System.UnauthorizedAccessException e) 


{ 
// Call a custom error logging procedure. 
LogError(e); 
// Re-throw the error. 
throw; 
} 


Finally 块 


可 以 使 用 finally 块 清理 在 try 块 中 执行 的 操作 。 如 果 存 在 ，finally 块 将 在 最 后 执 
行 ， 在 try 块 和 任何 匹配 catch 的 块 之 后 执行 。 不 管 是 否 引 发 异常 或 者 是 否 找到 和 与 
异常 类 型 匹配 的 catch 块 ，finally 始终 运行 。 


可 以 使 用 finally 块 释放 资源 (如 文件 流 、 数 据 库 连 接 和 图 形 句柄 ) ， 而 不 用 等 竺 
由 运行 时 中 的 垃圾 回收 器 来 完成 对 象 。 有 关 更 多 信息 ， 请 参见 Using 语句 (CHS 
考 ) 。 


在 下 面 的 示例 中 ， 使 用 finally 块 关闭 在 try 块 中 打开 的 文件 。 注 意 ， 在 关闭 文件 之 
前 要 检查 该 文件 句柄 的 状态 。 如 果 try 块 无 法 打开 文件 ， 则 文件 句柄 仍 具 有 值 
null， 并 且 finally 块 不 会 党 试 关闭 它 。 或 者 ， 如 果 在 try 块 中 成 功 打开 该 文件 ， 则 
finally 块 将 天 闭 打 开 的 文件 。 


System.IO.FileStream file - null; 
System. IO.FileInfo fileinfo = new System.10.FileInfo("C:\\file.txt' 
try 


file = fileinfo.Openwrite(); 
file.WriteByte(OxF); 


} 
finally 


// Check for null because Openwrite might have failed. 
if (file !- null) 


file.Close(); 





ee 
CH j2 Sas 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 
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SMR RIE (CH 编程 指南 ) 

try-catch (CK 参考 ) 

try-finally (C# 参考 ) 

try-catch-finally (C# 参考 ) 

using 语句 (CH 参考 ) 


创建 和 引发 异常 (C# RIERA) 
异常 用 于 指示 在 运行 程序 时 发 生 了 错误 。 此 时 将 创建 一 个 描述 错误 的 异常 对 象 ， 然 
后 使 用 throw 关键 字 ' 引 发 "该 对 象 。 然 后 运行 时 搜索 最 兼容 的 异常 多 理 程序 。 
当 存 在 下 列 一 种 或 多 种 情况 时 ， 程 序 员 应 引发 异常 
。 方法 无 法 完成 其 中 定义 的 功能 。 
例如 ， 如 果 方 法 的 参数 具有 无 效 值 : 


static void CopyObject(SampleClass original) 
{ 


if (original == null) 


throw new System.ArgumentException("Parameter cannot be 





e 根据 对 象 的 状态 ， 对 某 个 对 象 进行 不 适当 的 调用 。 
一 个 示例 可 能 党 试 对 只 读 文 件 执行 写 操 作 。 在 对 象 状 态 不 允许 某 项 操作 的 情况 


下 ， 引 发 InvalidOperationException 的 一 个 实例 或 基于 此 类 的 派生 类 的 对 象 。 
以 下 为 引发 InvalidOperationException 对 象 的 方法 的 示例 : 


class ProgramLog 


{ 
System.IO.FileStream logFile = null; 
void OpenLog(System.IO.FileInfo fileName, System.IO.FileMoc 
void WriteLog() 
if (!this.logFile.CanWwrite) 


throw new System.InvalidOperationException("Logfile 


// Else write data to the log and return. 





e 方法 的 参数 导致 了 异常 。 


在 此 情况 下 ， 应 捕获 原始 异常 并 创建 一 个 ArgumentException 实例 。 原 始 异 常 
应 作为 InnerException 参数 传递 给 ArgumentException KISH : 


static int GetValueFromArray(int[] array, int index) 


{ 
try 
{ 
return array[index]; 
} 
catch (System.IndexOutOfRangeException ex) 
System.ArgumentException argEx - new System.ArgumentExc 
throw argEx; 
} 
} 





异常 包含 一 个 名 为 StackTrace 的 属性 。 此 字符 串 包 含 当前 调用 堆栈 上 的 方法 的 名 
称 ， 以 及 为 每 个 方法 引发 异常 的 位 置 (文件 名 和 行 号 ) 。 StackTrace 对 象 由 公共 
语言 运行 时 (CLR) M throw 语句 点 开始 自动 创建 ， 因 此 必须 从 堆栈 跟踪 的 开始 点 
引发 异常 。 


所 有 异常 都 包含 一 个 名 为 Message 的 属性 。 应 该 设置 此 字符 串 来 解释 发 生 有 异常 的 
原因 。 注 意 ， 不 应 将 安全 敏感 信息 放 在 消息 文本 中 。 除 Message 之 

外 ，ArgumentException 还 包含 一 个 名 为 ParamName 的 属性 ， 应 将 该 属性 设置 为 
导致 引发 异常 的 参数 的 名 称 。 对 于 属性 设置 器 ，ParamName 应 设置 为 value。 


公共 的 受 保护 方法 应 在 其 无 法 完成 预期 功能 时 引发 异常 。 引 发 的 异常 类 应 该 是 符合 


错误 条 件 的 最 确切 的 可 用 异常 。 这 些 异常 应 编写 为 类 功能 的 一 部 分 ， 派 生 类 或 对 原 
始 类 的 更 新 应 保留 相同 的 行为 ， 以 实现 向 后 兼容 性 。 


引发 异 剃 时 要 避免 的 情 
下 表 确 定 了 在 引发 异常 时 要 避免 的 做 法 : 
。 不 应 使 用 异常 来 更 改正 常 执行 过 程 中 的 程序 流程 。 异 常 只 能 用 于 报告 和 处 理 错 


误 条 件 。 
e 只 能 引发 异常 ， 而 不 能 作为 返回 值 或 参数 返回 异常 。 


e 不 要 从 自己 的 源 代码 中 有 意 引发 
System.Exception, System.SystemException, System.NullReferenceExcept 
ion 或 System.IndexOutOfRangeException, 


e 不 要 创建 可 在 调试 模式 下 引发 但 不 会 在 发 布 模式 下 引发 的 异常 。 知 要 在 开发 阶 
段 确 定 运行 时 错误 ， 请 改 用 调试 断言 。 


定义 异 帅 类 


程序 可 以 引发 System 命名 空间 中 的 预定 义 异常 类 (前 面 注 明 的 情况 除外 ) , SH 
过 从 Exception 派生 来 创建 它们 自己 的 异常 类 。 派 生 类 至 少 应 定义 四 个 构造 画 数 : 
一 个 是 默认 构造 画 数 ， 一 个 用 来 设置 消息 属性 ， 一 个 用 来 设置 Message 属性 和 
E dE A 
列 如 : 


[Serializable()] 

public class InvalidDepartmentException : System.Exception 

{ 
public InvalidDepartmentException() : base() { } 
public InvalidDepartmentException(string message) : base(messat 
public InvalidDepartmentException(string message, System.Except 


// A constructor is needed for serialization when an 

// exception propagates from a remoting server to the client. 

protected InvalidDepartmentException(System.Runtime.Serializat: 
System.Runtime.Serialization.StreamingContext context) { } 


E 





仅 当 新 属性 提供 的 数据 有 助 于 解决 异常 时 ， 才 应 将 其 添加 到 异常 类 。 如 果 向 派生 的 
异常 类 添加 了 新 属性 ， 则 应 重 写 ToString() 以 返回 添加 的 信息 。 


n ze 

C# 语言 规 

有 关 详 细 信 息 ， 请 参阅 CË jz 言 规范 。 该 吾 言 规范 是 CH) Te 知 法 和 用 法 的 权威 资 料 。 
请 参阅 

C 编程 指南 

异常 和 异常 处 理 (C# 编程 指南 ) 


异常 层次 结 
异常 父 理 (CH 编程 指南 ) 


HitastERXBUSe*S (CH 编程 指 两 ) 


有 些 异 常 在 基本 操作 失败 时 由 .NET Framework 的 公共 语言 运行 时 (CLR) 自动 引 


发 。 下 表 列 出 了 这 些 异常 和 它们 的 和 


ix, 


dit 


c 
aT 


ArithmeticException 


ArrayTypeMismatchException 


DivideByZeroException 


IndexOutOfRangeException 


InvalidCastException 


NullReferenceException 
OutOfMemoryException 
OverflowException 
StackOverflowException 
TypelnitializationException 
请 参阅 
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异常 和 异常 处 理 (C# 编程 指南 ) 


异常 处 理 (C# 编程 指南 ) 
try-catch (C# 参考 ) 


说 明 
在 算术 运算 期 间 发 生 的 异常 (如 


DivideByZeroException 和 
OverflowException) 的 基 类 。 


当 数 组 存储 给 定 的 元 素 时 ， 如 果 由 于 该 元 素 的 
实际 类 型 与 数组 的 实际 类 型 不 兼容 而 导致 存储 
失败 ， 就 会 引发 此 异常 。 

Ex RA SREB SIR. 

在 尝试 为 数组 设置 小 于 需 或 超出 数组 界限 的 索 
引 时 引发 。 

当 从 基 类 型 到 接口 或 派生 类 型 的 显 式 转换 在 运 
行 时 失败 时 ， 就 会 引发 此 异常 。 

在 尝试 引用 值 为 null 的 对 象 时 引发 。 

在 使 用 new 运算 符 分 配 内 存 的 尝试 失败 时 引 
发 。 这 表明 可 用 于 公共 语言 运行 时 的 内 存 已 耗 
Bo 

f£ checked .E FICHE is SH B1 

2 

当 执 行 堆栈 由 于 具有 太 多 的 挂 起 方法 调用 而 耗 
尽 时 ， 就 会 引发 此 异常 ; 这 通常 表明 存在 非常 
深 的 递 具 或 无 限 递 当 。 

在 静态 构造 画 数 引发 异常 并 且 不 存在 可 以 捕捉 
到 它 的 兼容 catch 子 句 时 引发 。 


MSDN C# 编程 指南 & 参考 手册 2015 


try-finally (C# 参考 ) 
try-catch-finally (C# 参考 ) 


编译 器 生成 的 异常 (CH 编程 指南 ) 199 


如 何 : 使 用 try/catch 4385? 3$ (CH 编程 指南 ) 


try-catch 块 的 用 途 是 捕捉 和 处 理工 作 代 码 所 生成 的 异常 。 有 些 异常 可 以 在 catch 3 
中 处理， 解决 问题 后 不 会 再 次 引发 异常 ; 但 更 多 情况 下 ， 您 唯一 能 做 的 是 确保 引发 
适当 的 异常 。 


示例 
在 此 示例 中 ，IndexOutOfRangeException 不 是 最 适当 的 异常 : 对 本 方法 而 言 


ArgumentOutOfRangeException 更 恰当 些 ， 因 为 错误 是 由 调用 方 传人 的 index 参 
数 导 致 的 。 


class TestTryCatch 


{ 
static int GetInt(int[] array, int index) 
{ 
try 
{ 
return array[index]; 
} 
catch (System.IndexOutOfRangeException e) // CS0168 
{ 
System.Console.WriteLine(e.Message); 
// Set IndexOutOfRangeException to the new exception's 
throw new System.ArgumentOutOfRangeException("index pa! 
} 
} 
} 





注释 


导致 异常 的 代码 被 括 在 try 块 中 。 在 其 后 面 紧 接着 添加 一 个 catch 语句 ， 以 便 在 
IndexOutOfRangeException 发 生 时 对 其 进行 处 理 。 catch 块 处 理 
IndexOutOfRangeException， 并 引发 更 适当 的 ArgumentOutOfRangeException = 
常 。 为 给 调用 方 提供 尽 可 能 多 的 信息 ， 应 考虑 将 原始 异常 指定 为 新 异常 的 
InnerException。 因为 InnerException 属性 是 只 读 ， 所 以 必须 在 新 异常 的 构造 画 数 
中 为 其 赋值 。 


请 参见 
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TAIE (CH 编程 指南 ) 异常 处 理 (C# 编程 指南 ) 


机 
di 
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yu 


CH 编程 指南 


如 何 : 使 用 try/catch 义理 异常 (CH 编程 指南 ) 


如 何 : 使 用 finally 执行 清理 代码 (CH 编程 指南 ) 


finally 语句 的 目的 是 确保 即使 在 引发 异常 的 情况 下 也 能 立即 进行 必要 的 对 象 (通常 
是 保存 外 部 资源 的 对 象 ) 清理 。 此 类 清理 功能 的 一 个 示例 是 在 使 用 后 立即 对 
FileStream 调用 Close， 而 不 是 等 待 公共 语 羊 运行 时 对 该 对 象 进行 垃圾 回收 ， 如 下 
所 示 : 


static void CodewithoutCleanup() 


{ 
System.IO.FileStream file = null; 
System.IO.FileInfo fileInfo = new System.10.FileInfo("C:\\file 
file = fileInfo.Openwrite(); 
file.writeByte(OXF); 
file.Close(); 
} 





为 了 将 上 面 的 代码 转换 为 try-catch-finally 语句 ， 需 要 将 清理 代码 与 工作 代码 分 
开 ， 如 下 所 示 。 


static void CodewithCleanup( ) 


1 
System.IO.FileStream file - null; 


System.IO.FileInfo fileInfo = null; 
try 
fileInfo = new System.IO.FileiInfo("C:NNfile.txt"); 


file = fileInfo.Openwrite(); 
file.writeByte(OXxF); 


catch(System.UnauthorizedAccessException e) 


t 

System.Console.WriteLine(e.Message); 
J 
finally 

if (file !- null) 

file.Close(); 

} 

} 


因为 在 OpenWrite() 调用 前 ，try 块 内 随时 都 有 可 能 发 生 异 常 ，OpenWrite() 调用 本 
身 也 有 可 能 失败 ， 所 以 我 们 无 法 保证 该 文件 在 我 们 尝试 关闭 它 时 处 于 打开 状态 。 
finally 块 添加 了 一 项 检查 ， 以 确保 在 调用 Close 方法 前 ，FileStream 对 象 不 为 
null。 如 果 没有 null 检查 ，finally 块 可 能 引发 自身 的 NullReferenceException, 1B 
是 应 当 尽 可 能 避免 在 finally 块 中 引发 异常 。 


ft finally 块 中 关闭 数据 库 连 接 是 另 一 个 不 错 的 选择 。 因 为 有 时 候 数据 库 服务 器 多 
许 的 连接 数 是 有 限 的 ， 所 以 应 尽快 关闭 数据 库 连接 。 在 由 于 引发 了 异常 而 无 法 关闭 
连接 的 情况 下 ， 使 用 finally 块 也 是 比 等 待 垃圾 回收 更 好 的 一 种 选择 。 


请 参阅 
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异常 和 异常 处 理 (C# 编程 指南 ) 
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using 语句 (CH 参考 ) 

try-catch (C# 参考 ) 

try-finally (C# 参考 ) 
try-catch-finally (C£ 参考 ) 


如 何 : 捕捉 非 CLS HE 


包括 C++/CLI 在 内 的 某 些 NET 语言 允许 对 象 引 发 不 是 由 Exception 派生 的 异常 。 
这 类 异常 称 为 “ 非 CLS 异常 或 “ 非 异 常 "。 在 Visual C£ 中 ， 您 不 能 引发 非 CLS & 
常 ， 但 是 可 以 采用 两 种 方法 捕捉 这 类 异常 : 


e 在 catch (Exception e) 块 中 作为 RuntimeWrappedException 捕捉 。 


默认 情况 下 ，Visual C£ 程序 集 将 非 CLS 异常 作为 包装 异常 来 捕捉 。 如 果 需 要 
访问 可 通过 WrappedException 属性 访问 的 原始 有 异常， 请 使 用 此 方法 。 本 主题 
后 面 的 过 程 将 解释 如 何 使 用 此 方式 捕捉 异常 。 


e 在 位 于 catch (Exception) 或 catch (Exception e) 块 之 后 的 常规 catch 块 (没有 
指定 异常 类 型 的 catch 块 ) 中 。 


如 果 您 要 执行 某 个 操作 (如 写 入 日 志文 件 ) 以 响应 非 CLS 异常 ， 并 且 不 需要 
访问 异常 信息 ， 请 使 用 此 方法 。 默 认 情 况 下 ， 公 共 语 言 运行 时 会 包装 所 有 异 
常 。 要 禁用 此 行为 ， 请 将 程序 集 级 别 特 性 添加 到 您 的 代码 中 ， 该 特性 通常 在 
AssemblyInfo.cs 文件 中 。[assembly: 
RuntimeCompatibilityAttribute(WrapNonExceptionThrows = false)] 


捕捉 非 CLS FH 


1. f£ catch(Exception e) block rh, f&FH as 关键 字 来 测试 e 能 否 强制 转换 为 
RuntimeWrappedException, 


2. 通过 WrappedException 属性 访问 原始 异常 。 
下 面 的 示例 演示 如 何 捕捉 由 使 用 C++/CLR 编写 的 类 库 引 发 的 非 CLS 异常 。 请 注 
意 ， 在 此 示例 中 ，Visual C# 客户 端 代码 事先 已 经 知道 要 引发 的 异常 类 型 为 


System.String。 只 要 WrappedException 属性 的 原始 类 型 可 通过 您 的 代码 来 访问 ， 
就 可 以 将 该 属性 强制 转换 回 其 原始 类 型 。 


// Class library written in C++/CLR. 
ThrowNonCLS.Classi myClass = new ThrowNonCLS.Class1i(); 


try 
// throws gcnew System: :String( 


// "I do not derive from System.Exception!"); 
myClass.TestThrow(); 


j 


catch (Exception e) 


RuntimewrappedException rwe = e as RuntimeWrappedException; 
if (rwe !- null) 


{ 
String s = rwe.WrappedException as String; 
if (s != null) 
{ 
Console.WriteLine(s); 
} 
} 
else 
// Handle other System.Exception types. 
} 
} 
请 参阅 


RuntimeWrappedException 
异常 和 异常 处 理 (C# 编程 指南 ) 
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文件 系统 和 注册 表 (CH 编程 指 两 ) 


以 下 主题 说 明 如 何 使 用 C# 和 NET Framework 对 文件 、 文 件 夹 和 注册 表 执 行 各 种 


基本 操作 。 


本 节 内 容 


标题 


如 何 : 循环 访问 目录 树 (CH 编程 
指南 ) 


如 何 : 获取 有 关 文 件 、 文 件 夹 和 驱 
动 器 的 信息 (C# 编程 指南 ) 


如 何 : 创建 文件 或 文件 夹 (CH 编 
程 指 南 ) 


如 何 : 复制 、 删 除 和 移动 文件 和 文 
件 夹 〈C# 编程 指南 ) 


如 何 : 提供 文件 操作 进度 对 话 框 
(C# 编程 指南 ) 


如 何 : 写 入 文本 文件 (C# 编程 指 


南 ) 


如 何 : 读 取 文 本 文件 中 的 内 容 (C# 
编程 指南 ) 


如 何 : 一 次 一 行 地 读 取 文 本 文件 
(Visual C£) 


如 何 : 在 注册 表 中 创建 注册 表 项 
(Visual C£) 


相关 章节 


文件 和 流 VO 

如 何 : 复制 、 删 除 和 移动 文件 和 文件 夹 
C# 编程 指南 

System.1O 


文件 系统 和 注册 表 (CH 编程 指南 ) 


说 明 
说 明 如 何 手动 循环 访问 目录 树 。 


说 明 如 何 检 索 有 关 文 件 、 文 件 夹 和 了 驱动 器 
的 信息 ， 例 如 创建 时 间 和 大 小 。 


说 明 如 何 创建 新 文件 或 文件 夹 。 
说 明 如 何 复制 、 删 除 和 移动 文件 和 文件 


o 


说 明 如 何 为 某 些 文件 操作 显示 标准 的 
Windows 进度 对 话 框 。 


说 明 如 何 写 入 文本 文件 。 
说 明 如 何 读 取 文本 文件 中 的 内 容 。 
说 明 如 何 一 次 从 文件 中 检索 一 行文 本 。 


说 明 如 何 向 系统 注册 表 中 写 入 项 。 


(C# 编程 指南 ) 


如 何 : 循环 访问 目录 树 (CH 编程 指南 ) 


词组 “循环 访问 目 d 的 意思 是 在 指定 的 根 文件 夹 下 ， 访 问 每 个 族 套 子 目 录 中 任意 
深度 的 所 有 文件 。 您 不 必 打 开 每 一 个 文件 。 可 以 只 检索 string 形式 的 文件 名 或 子 目 
录 名 ， 或 者 可 以 检索 System.IO.Filelnfo 或 System.IO.Directorylnfo 对 象形 式 的 其 
他 信息 。 


Ss xir 
Ef TER 


在 Windows 中 ， 可 交换 使 用 术语 “目录 ”和 “文件 夹 "。 大 多 数 文档 和 用 户 界 面 文 
本 使 用 术语 “文件 夹 ”"， 但 .NET Framework 类 库 使 用 术语 “目录 ”。 


最 简单 的 例子 ， 如 果 您 确信 您 拥有 指定 根 目 录 下 所 有 目录 的 访问 权限 ， 则 您 可 以 使 
用 System.IO.SearchOption.AllDirectories 标志 。 该 标志 返回 与 指定 模式 相 匹 配 的 
所 有 谋 套 子 目录 。 下 面 的 示例 演示 如 何 使 用 该 标志 。 


root.GetDirectories("*.*", System.IO.SearchOption.AllDirectories); 
SSS Og 


此 方法 的 缺点 是 ， 如 果 指 定 根 目录 下 任何 一 个 子 目 录 引 发 了 
DirectoryNotFoundException 或 UnauthorizedAccessException， 则 整个 方法 将 会 
失败 并 且 不 返回 任何 目录 。 使 用 GetFiles 方法 时 也 是 如 此 。 如 果 一 定 要 义理 特定 子 
文件 夹 中 的 这 些 异 常 ， 则 必须 手动 通 历 该 目录 树 ， 如 下 面 的 示例 所 示 。 


手动 通 历 目录 树 时 ， 可 以 先 处 理子 目录 (IRR) ， 或 者 可 以 先 处 理 文 件 (后 序 
JA). 如 果 执 行 前 序 静 历 ， 则 在 循环 访问 直接 位 于 当前 文件 夹 本 身 中 的 文件 之 
前 ， 请 先 通 历 当前 文件 夹 下 的 整个 树 。 本 文档 后 面 的 示例 执行 的 是 后 序 通 历 ， 但 您 
可 以 轻松 地 将 它们 修改 为 执行 前 序 通 历 。 


另外 还 可 以 选择 是 使 用 递 当 通 历 ， 还 是 使 用 基于 堆栈 的 通 历 。 本 文档 后 面 的 示例 对 
这 两 种 方法 进行 了 演示 。 


如 果 必 须 对 文件 和 文件 夹 上 执行 各 种 操作 ， 则 可 以 通过 下 面 的 方法 将 这 些 示例 模块 
化 : 将 操作 重 构 到 单独 的 函数 ， 这 样 您 就 可 以 通过 单个 委托 来 调用 这 些 函 数 。 


Wi ERE 
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NTFS 文件 系统 可 以 包含 交接 点 、 符 号 链接 和 硬 链 接 形式 的 重新 分 析 点 。.NET 
Framework 方法 (如 GetFiles 和 GetDirectories) eiam a e 
何 子 目 录 。 此 行为 可 防止 两 个 重新 分 析 点 相互 引用 时 陷入 无 限 循 环 。 通 常 ， 为 
了 确保 您 不 会 无 意 修 改 或 删除 文件 ， 在 使 用 重新 分 析 点 时 应 特别 小 心 。 
要 精 E MINIS 请 使 用 平台 调用 或 本 机 代码 直接 调用 相应 的 Win32 xc 
«aA: 
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对 于 所 处 理 的 特定 异常 以 及 在 每 个 文件 和 文件 天 上 执行 的 特定 操作 ， 都 只 是 作为 示 
例 提供 。 您 应 该 修改 此 代码 来 满足 自己 特定 的 需要 。 有 关 更 多 信息 ， 请 参见 代码 中 


的 注释 。 


public class RecursiveFileSearch 


( 


static System.Collections.Specialized.StringCollection log = ne 


static void Main() 


( 


j 


// Start with drives if you have to search the entire compi 
string[] drives - System.Environment.GetLogicalDrives(); 


foreach (string dr in drives) 


{ 
System.IO.DriveInfo di = new System.IO.DriveInfo(dr); 
// Here we skip the drive if it is not ready to be reac 
// is not necessarily the appropriate action in all sce 
if (!di.IsReady) 
{ 
Console.WriteLine("The drive {0} could not be read' 
continue; 
} 
System.IO.DirectoryInfo rootDir = di.RootDirectory; 
WalkDirectoryTree(rootDir); 
} 


// Write out all the files that could not be processed. 
Console.WriteLine("Files with restricted access:"); 
foreach (string s in log) 


{ 
} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key"); 
Console.ReadKey(); 


Console.WriteLine(s); 


static void WalkDirectoryTree(System.IO.DirectoryInfo root) 


( 


System.IO.FileInfo[] files - null; 
System.IO.DirectoryInfo[] subDirs - null; 


// First, process all the files directly under this folder 
try 
{ 


j 


// This is thrown if even one of the files requires permis: 
// than the application provides. 
catch (UnauthorizedAccessException e) 


files = root.GetFiles("*.*"); 


// This code just writes out the message and continues 
// You may decide to do something different here. For 4 
// can try to elevate your privileges and access the f: 
log.Add(e.Message); 


} 
catch (System.IO.DirectoryNotFoundException e) 
{ 
Console.WriteLine(e.Message); 
} 
if (files != null) 
{ 
foreach (System.IO.FileInfo fi in files) 
{ 
// In this example, we only access the existing Fi. 
// want to open, delete or modify the file, then 
// a try-catch block is required here to handle the 
// where the file has been deleted since the call 1 
Console.WriteLine(fi.FullName); 
} 
// Now find all the subdirectories under this director 
subDirs - root.GetDirectories(); 
foreach (System.IO.DirectoryInfo dirInfo in subDirs) 
{ 
// Resursive call for each subdirectory. 
WalkDirectoryTree(dirInfo); 
} 
} 





下 面 的 示例 演示 在 不 使 用 递 为 的 情况 下 如 何 循环 访问 目录 树 中 的 文件 和 文件 夹 。 该 
技术 使 用 泛 型 Stack<T> 集合 类 型 ， 该 类 型 是 一 个 后 进 先 出 (LIFO) HER. 


对 于 所 处 理 的 特定 异常 以 及 在 每 个 文件 和 文件 夹 上 执行 的 特定 操作 ， 都 只 是 作为 示 
例 提供 。 您 应 该 修改 此 代码 来 满足 自己 特定 的 需要 。 有 关 更 多 信息 ， 请 参见 代码 中 
的 注释 。 


public class StackBasedIteration 
1 
static void Main(string[] args) 
{ 
// Specify the starting folder on the command line, or in 
// Visual Studio in the Project > Properties > Debug pane. 
TraverseTree(args[0]); 


} 


Console.WriteLine("Press any key"); 
Console.ReadKey(); 


public static void TraverseTree(string root) 


( 


// Data structure to hold names of subfolders to be 
// examined for files. 
Stack<string> dirs = new Stack<string>(20); 


if (!System.IO.Directory.Exists(root)) 


i 
} 


thr 


ow new ArgumentException(); 


dirs.Push(root); 


while (dirs.Count > 0) 


D 


str 
str 
try 
{ 


cat 


{ 


} 


cat 


{ 


} 


str 
try 
{ 


} 


cat 


{ 


ing currentDir = dirs.Pop(); 
ing[] subDirs; 


subDirs = System.IO.Directory.GetDirectories(currer 


An UnauthorizedAccessException exception will be thi 
discovery permission on a folder or file. It may or 
to ignore the exception and continue enumerating the 
folders. It is also possible (but unlikely) that a I 
will be raised. This will happen if currentDir has I 
another application or thread after our call to Dire 
choice of which exceptions to catch depends entirel\ 
you are intending to perform and also on how much yc 
about the systems on which this code will run. 

ch (UnauthorizedAccessException e) 


Console.WriteLine(e.Message); 
continue; 


ch (System.IO.DirectoryNotFoundException e) 
Console.WriteLine(e.Message); 

continue; 

ing[] files = null; 


files = System.IO.Directory.GetFiles(currentDir); 


ch (UnauthorizedAccessException e) 


Console.WriteLine(e.Message); 
continue; 


} 
catch (System.IO.DirectoryNotFoundException e) 


Console.WriteLine(e.Message); 
continue; 


// Perform the required action on each file here. 
// Modify this block to perform your required task. 
foreach (string file in files) 


{ 
try 
// Perform whatever action is required in your 
System.IO.FileInfo fi = new System.IO.FileInfoi 
Console.WriteLine("{0}: {1}, {2}", fi.Name, fi 
} 
catch (System.IO.FileNotFoundException e) 
// If file was deleted by a separate applicati 
// or thread since the call to TraverseTree() 
// then just continue. 
Console.WriteLine(e.Message); 
continue; 
} 
} 


// Push the subdirectories onto the stack for traversa: 
// This could also be done before handing the files. 
foreach (string str in subDirs) 

dirs.Push(str); 





通常 ， 测 试 每 个 文件 夹 以 确定 您 的 应 用 程序 是 否 有 权限 打开 它 是 非常 耗 时 的 。 因 
此 ， 代 码 示例 只 是 将 该 部 分 操作 放 到 了 一 个 try/catch 块 内 。 您 可 以 修改 该 catch 
ee 您 可 以 提升 自己 的 权限 ， 然 后 再 次 访问 
它 。 通 常 ， 只 捕捉 那些 无 需 使 点 用 程序 停留 在 一 个 未 知 状态 就 可 以 处 理 的 异常 。 


如 果 必 须 将 目 录 树 的 内 容 存储 到 内 存 或 磁盘 中 ， 则 最 好 只 存储 每 个 文件 的 
FullName 属性 (string 类 型 ) 。 然 后 ， 可 以 根据 需 D 3m 个 新 的 
Filelnfo 或 DirectoryInfo 对 象 ， 或 者 打开 任何 需要 进行 其 他 处 理 的 文件 。 


可 靠 编程 


MSDN CZ 编程 指南 & 参考 手册 2015 


可 靠 文件 迭代 代码 必须 考虑 文件 系统 的 诸多 复杂 性 。 有 关 更 多 信息 ， 请 参见 NTFS 
Technical Reference (NTFS 技术 参考 ) 。 


请 参阅 
System.IO 


LINQ and File Directories 
文件 系统 和 注册 表 (CH 编程 指南 ) 
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如 何 : 获取 有 关 文 件 、 文 件 夹 和 驱动 器 的 信息 (CH 
编程 指 两 ) 
在 .NET Framework 中 ， 可 以 使 用 以 下 类 来 访问 文件 系统 信息 : 

e System.IO.Filelnfo 

e System.IO.Directorylnfo 

e System.IO.Drivelnfo 

e System.IO.Directory 


e System.lO.File 


Filelnfo 和 DirectoryInfo 类 表示 文件 或 目录 ， 包 含 公开 NTFS 文件 系统 所 支持 的 很 
多 文件 特性 的 属性 ， 同 时 还 包含 用 于 打开 、 关 闭 、 移 动 和 删除 文件 和 文件 夹 的 方 
法 。 可 以 通过 将 表示 文件 、 文 件 夹 或 驱动 器 名 称 的 字符 串 传 递 到 下 面 的 构造 范 数 来 
创建 这 些 类 的 实例 : 


System.IO.DriveInfo di = new System.IO.DriveInfo(Q"C:N"); 


此 外 ， 还 可 以 通过 调用 DirectoryInfo.GetDirectories, DirectoryInfo.GetFiles 和 
Drivelnfo.RootDirectory 来 获取 文件 、 文 件 夹 或 驱动 器 的 名 称 。 


System.IO.Directory 和 System.IO.File 类 提供 用 于 检索 有 关 目 录 和 文件 的 信息 的 静 
态 方法 。 


下 面 的 示例 演示 访问 有 关 文 件 和 文件 夹 的 信息 的 各 种 方法 。 


class FileSysInfo 
{ 
static void Main() 
{ 
// You can also use System.Environment.GetLogicalDrives to 
// obtain names of all logical drives on the computer. 
System.IO.DriveInfo di = new System.IO.DriveInfo(Q"C:N"); 
Console.WriteLine(di.TotalFreeSpace); 
Console.WriteLine(di.VolumeLabel); 


// Get the root directory and print out some information al 
System.IO.DirectoryInfo diriInfo = di.RootDirectory; 
Console.WriteLine(dirInfo.Attributes.ToString()); 


// Get the files in the directory and print out some inforr 
System.IO.FileInfo[] fileNames - dirInfo.GetFiles("*.*"); 


foreach (System.IO.FileInfo fi in fileNames) 


i 
} 


// Get the subdirectories directly that is under the root. 
// See "How to: Iterate Through a Directory Tree" for an e> 
// iterate through an entire tree. 

System.IO.DirectoryInfo[] dirinfos = dirInfo.GetDirectorie: 


Console.WriteLine("{O}: {1}: {2}", fi.Name, fi.LastAcce 


foreach (System.IO.DirectoryInfo d in dirInfos) 


{ 
} 


// The Directory and File classes provide several static me 
// for accessing files and directories. 


Console.WriteLine(d.Name); 


// Get the current application directory. 
string currentDirName = System.IO.Directory.GetCurrentDire« 
Console.WriteLine(currentDirName); 


// Get an array of file names as strings rather than FileIr 
// Use this method when storage space is an issue, and wher 
// hold on to the file name reference for a while before yc 
// the file. 

string[] files - System.IO.Directory.GetFiles(currentDirNar 


foreach (string s in files) 
{ 
// Create the FileInfo object only when needed to ensui 
// the information is as current as possible. 
System.IO.FileInfo fi - null; 
try 
{ 
fi = new System.IO.FileInfo(s); 


catch (System.IO.FileNotFoundException e) 
{ 
// To inform the user and continue is 
// sufficient for this demonstration. 
// Your application may require different behavior 
Console.WriteLine(e.Message); 
continue; 
} 
Console.WriteLine("{O} : (1)",fi.Name, fi.Directory); 


} 


// Change the directory. In this case, first check to see 
// whether it already exists, and create it if it does not 
// If this is not appropriate for your application, you car 
// handle the System.IO.IOException that will be raised if 
// directory cannot be found. 


if (!System.1I0.Directory.Exists(@"C:\Users\Public\TestFolde 
1 


j 


System.IO.Directory.SetCurrentDirectory(Q"C:NUsersNPublicNV 


System.IO.Directory.CreateDirectory(Q"C:NUsersNPublicNV 


currentDirName - System.IO.Directory.GetCurrentDirectory(), 
Console.WriteLine(currentDirName); 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 





可 靠 编程 


处 理 用 户 指定 的 路 径 字 符 串 时 ， 还 应 处 理 在 以 下 情况 下 引发 的 异常 : 

e 文件 名 的 格式 不 正确 。 例 如 ， 包 含 无 效 字 符 或 仅 包含 空白 。 

e 文件 名 为 空 。 

e. 文件 名 长 于 系统 定义 的 最 大 长 度 。 

e 文件 名 包含 冒号 (:)。 
如 果 应 用 程序 不 具有 读 取 指定 文件 所 需 的 足够 权限 ， 则 无 论 路 径 是 否 存在 ，Exists 
方法 都 将 返回 false ; 该 方法 不 引发 异常 。 


请 参阅 

System.IO 

CH 编程 指南 
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您 可 通过 编程 方式 在 您 的 计算 机 上 创建 文件 夹 、 子 文件 夹 和 子 文件 夹 中 的 文件 ， 并 
将 数据 写 入 文件 。 


public class CreateFileOrFolder 


{ 


static void Main() 


( 


// Specify a name for your top-level folder. 
string folderName = @"c:\Top-Level Folder"; 


// To create a string that specifies the path to a subfolde 
// top-level folder, add a name for the subfolder to folden! 
string pathString = System.IO.Path.Combine(folderName, "Sut 


// You can write out the path name directly instead of usir 
// method. Combine just makes the process easier. 
string pathString2 = Q"c:NTop-Level Folder\SubFolder2"; 


// You can extend the depth of your path if you want to. 
//pathString = System.IO.Path.Combine(pathString, "SubSubF« 


// Create the subfolder. You can verify in File Explorer tl 
// structure in the C: drive. 

// Local Disk (C:) 

// Top-Level Folder 

// SubFolder 
System.IO.Directory.CreateDirectory(pathString); 


// Create a file name for the file you want to create. 
string fileName = System.IO.Path.GetRandomFileName(); 


// This example uses a random string for the name, but you 
// a particular name. 
//string fileName - "MyNewFile.txt"; 


// Use Combine again to add the file name to the path. 
pathString - System.IO.Path.Combine(pathString, fileName); 


// Nerify the path that you have constructed. 
Console.WriteLine("Path to my file: {0}\n", pathString); 


// Check that the file doesn't already exist. If it doesn't 
// the file and write integers 0 - 99 to it. 

// DANGER: System.IO.File.Create will overwrite the file il 
// This could happen even with random file names, although 
if (!System.IO.File.Exists(pathString)) 


i 


using (System.IO.FileStream fs = System.IO.File.Createl| 
for (byte i = 0; i < 100; i++) 
fs.WriteByte(i); 
5 
} 
else 
Console.WriteLine("File \"{O}\" already exists.", file! 


return; 


} 


// Read and display the data from your file. 
try 


{ 
byte[] readBuffer = System.IO.File.ReadAllBytes(pathStı 


foreach (byte b in readBuffer) 


Console.write(b + " "); 


} 


Console.WriteLine(); 
catch (System.IO.IOException e) 


Console.WriteLine(e.Message); 


j 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


// Sample output: 

// Path to my file: c:NTop-Level FolderNSubFolderNttxvauxe.vvO 
7/0 1234 5.6 7.8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 2: 
//30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 ! 


// 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 
//3 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 





ss 一 


如 果 该 文件 夹 已 存在 ， 则 CreateDirectory 不 执行 任何 操作 ， 且 不 会 引发 异常 。 但 
是 ，File.Create 用 新 的 文件 替换 现 有 文件 。 该 示例 使 用 一 个 if-else 语句 阻止 现 有 
文件 被 替换 。 


通过 在 示例 中 做 出 以 下 更 改 ， 您 可 以 根据 具有 某 个 名 称 的 程序 是 否 存 在 来 指定 不 同 
的 结果 。 如 果 该 文件 不 存在 ， 代 码 将 创建 一 个 文件 。 如 果 该 文件 存在 ， 代 码 将 把 数 
据 添 加 到 该 文件 中 。 


。 指定 一 个 非 随机 文件 名 。 


// Comment out the following line. 
//string fileName = System.IO.Path.GetRandomFileName(); 


// Replace that line with the following assignment. 
string fileName = "MyNewFile.txt"; 


e 用 以 下 代码 中 的 using 语句 替换 if-else 语句 。 


using (System.IO.FileStream fs = new System.IO.FileStream(pathS 


for (byte i = 0; i &lt; 100; i++) 


fs.WriteByte(i); 





运行 该 示例 若干 次 以 验证 数据 是 否 每 次 都 添加 到 文件 中 。 
有 关 更 多 可 以 党 斌 的 FileMode 值 的 信息 ， 请 参阅 FileMode。 
以 下 情况 可 能 会 导致 异常 : 


e 文件 夹 名 称 格式 不 正确 。 例 如 ， 它 包含 非法 字符 或 信友 是 空白 
(ArgumentException 类 ) 。 使 用 Path 类 创建 有 效 路 径 名 。 


要 创建 的 文件 夹 的 父 文 件 夹 是 只 读 的 〈IOException 类 ) 。 
文件 夹 名 称 是 null (ArgumentNullException 类 ) 。 

e 文件 夹 名 称 太 长 (PathTooLongException X) 。 

e 文件 夹 名 称 只 是 冒号 “:”(PathTooLongException X) 。 


.NET Framework 安全 性 

在 部 分 信任 的 情况 下 可 能 会 引发 SecurityException 类 的 实例 。 

如 果 没 有 创建 文件 夹 的 权限 ， 则 该 示例 引发 UnauthorizedAccessException 类 的 实 
例 。 

请 参阅 

System.IO 
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E : 复制 、 删 除 和 移动 文件 和 文件 夹 (C# 编程 指 


以 下 示例 说 明 如 何 使 用 System.IO 命名 空间 中 的 

System.IO.File, System.IO.Directory, System.IO.Filelnfo 和 
System.IO.DirectoryInfo 类 以 同步 方式 复制 、 移 动 和 删除 文件 和 文件 夹 。 这 些 示人 
没有 提供 进度 栏 或 其 他 任何 用 户 界 面 。 如 果 您 想 提 供 一 个 标准 进度 对 话 框 ， 请 参见 
如 何 : 提供 文件 操作 进度 对 话 框 (CH 编程 指南 ) o 


在 操作 多 个 文件 时 ， 请 使 用 System.IO.FileSystemWatcher 提供 一 些 事件 ， 以 便 可 
以 利用 这 些 事件 计算 进度 。 另 一 种 方法 是 使 用 平台 调用 来 调用 whew Shell 中 相 
应 的 文件 相关 方法 。 有 关 如 何 异 步 执行 这 些 文件 操作 的 信息 ， 请 人 参见 异步 文件 

1/0. 


示例 


下 面 的 示例 演示 如 何 复制 文件 和 目录 。 


// Simple synchronous file copy operations with no user interface. 
// To run this sample, first create the following directories and ! 
// C:NUsersNPublicNTestFolder 

// C:NUsersNPublicNTestFolderNtest.txt 

// C:NUsersNPublicNTestFolderNSubDirNtest.txt 

public class SimpleFileCopy 

1 


static void Main() 
{ 
string fileName = "test.txt"; 
string sourcePath = @"C:\Users\Public\TestFolder"; 
string targetPath @"C:\Users\Public\TestFolder\SubDir"; 


// Use Path class to manipulate file and directory paths. 
string sourceFile = System.IO.Path.Combine(sourcePath, fil: 
string destFile - System.IO.Path.Combine(targetPath, fileN: 


// TO copy a folder's contents to a new location: 
// Create a new target folder, if necessary. 
if (!System.IO.Directory.Exists(targetPath)) 


System.IO.Directory.CreateDirectory(targetPath); 
j 


// To copy a file to another location and 
// overwrite the destination file if it already exists. 
System.IO.File.Copy(sourceFile, destFile, true); 


// To copy all the files in one directory to another direc! 
// Get the files in the source folder. (To recursively ite! 
// all subfolders under the current directory, see 

// "How to: Iterate Through a Directory Tree.") 

// Note: Check for target path was performed previously 


// in this code example. 
if (System.IO.Directory.Exists(sourcePath)) 
{ 


string[] files = System.IO.Directory.GetFiles(sourcePa! 


// Copy the files and overwrite destination files if tl 
foreach (string s in files) 


{ 
// Use static Path methods to extract only the file 
fileName = System.IO.Path.GetFileName(s); 
destFile = System.IO.Path.Combine(targetPath, file! 
System.IO.File.Copy(s, destFile, true); 
} 
} 
else 
{ 
Console.WriteLine("Source path does not exist!"); 
} 


// Keep console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 





下 面 的 示例 演示 如 何 移动 文件 和 目录 。 


// Simple synchronous file move operations with no user interface. 
public class SimpleFileMove 
1 
static void Main() 
{ 
string sourceFile = @"C:\Users\Public\public\test.txt"; 
string destinationFile = @"C:\Users\Public\private\test.tx1 


// To move a file or folder to a new location: 
System.IO.File.Move(sourceFile, destinationFile); 


// To move an entire directory. To programmatically modify 
// path strings, use the System.IO.Path class. 
System.I0.Directory.Move(@"C:\Users\Public\public\test\", ( 





下 面 的 示例 演示 如 何 删 除 文件 和 目录 。 


// Simple synchronous file deletion operations with no user interf: 
// To run this sample, create the following files on your drive: 
// C:NUsersNPublicNDeleteTestNtesti.txt 

// C:\Users\Public\DeleteTest\test2.txt 

// C:\Users\Public\DeleteTest\SubDir\test2.txt 


public class SimpleFileDelete 
{ 


static void Main() 


// Delete a file by using File class static method... 
if(System.1I0.File.Exists(@"C:\Users\Public\DeleteTest\test 
{ 

// Use a try block to catch IOExceptions, to 

// handle the case of the file already being 

// opened by another process. 

try 

{ 


j 
catch (System.IO.IOException e) 


( 


System.IO.File.Delete(Q"C:NUsersNPublicNDeleteTest" 


Console.WriteLine(e.Message); 
return; 


j 


// ...O0r by using FileInfo instance method. 
System.IO.FileInfo fi = new System.IO.FileInfo(Q"C:NUsersN 


try 


{ 
fi.Delete(); 
} 
catch (System.IO.IOException e) 
{ 
Console.WriteLine(e.Message); 
} 
// Delete a directory. Must be writable or empty. 
try 
{ 
System.IO.Directory.Delete(Q"C:NUsersNPublicNDeleteTes! 
j 
catch (System.IO.IOException e) 
{ 
Console.WriteLine(e.Message); 
} 


// Delete a directory and all subdirectories with Director 
if(System.IO.Directory.Exists(Q"C:NUsersNPublicNDeleteTest' 


{ 
try 
t 


} 


catch (System.IO.IOException e) 
{ 


} 


System.I0.Directory.Delete(@"C:\Users\Public\Delete 


Console.WriteLine(e.Message); 


j 


// ...O0r with DirectoryInfo instance method. 
System.IO.DirectoryInfo di = new System.IO.DirectoryInfo(Q' 
// Delete this dir and all subdirs. 

try 


di.Delete(true); 


j 
catch (System.IO.IOException e) 


{ 


Console.WriteLine(e.Message); 
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任务 

如 何 : 提供 文件 操作 进度 对 话 框 (CH 编程 指南 ) 
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System.1O 
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CH 编程 指南 通用 VO 任务 

其 他 资源 
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如 何 : 提供 文件 操作 进度 对 话 框 〈C# 编程 指南 ) 


如 果 您 使 用 Microsoft. VisualBasic 命名 空间 里 的 CopyFile(String, String, 
UlOption) 方法 ， 则 可 以 提供 能 够 显示 Windows 中 文件 操作 进程 的 标准 对 话 框 。 


8 注意 

以 下 说 明 中 的 某 些 Visual Studio 用 户 界 面 元 素 在 计算 机 上 出 现 的 名 称 或 位 置 可 
能 会 不 同 。 这 些 元 素 取 决 于 你 所 使 用 的 Visual Studio 版 本 和 你 所 使 用 的 设置 。 
有 关 详 细 信 息 ， 请 参阅 个 性 化 Visual Studio IDE, 


在 Visual Studio 中 添加 引用 


1. 在 菜单 烂 上 ， 依 次 选择 “项 目 ”"” “添加 引用 ”。 
出 现 “ 引 用 管理 器 "对 话 框 。 
2. 在 “程序 集 ” 区 域 中 ， 选 择 “ 框 架 *” (如果 尚 未 选择 ) 。 


3. 在 名 称 列表 中 ， 选 中 “Microsoft.VisualBasic" 复 选 框 ， 然 后 选择 “确定 "按钮 关闭 
对 话 框 。 


下 面 的 代码 将 sourcePath 指定 的 目录 复制 到 destinationPath 指定 的 目录 中 。 此 代 
码 还 提供 一 个 标准 对 话 框 ， 该 对 话 框 显示 预计 完成 操作 还 需要 的 时 间 量 。 


// The following using directive requires a project reference to M: 
using Microsoft.VisualBasic.FileIO; 


class FileProgress 
{ 
static void Main() 
{ 
// Specify the path to a folder that you want to copy. If 1 
// you won't have time to see the progress dialog box. 
string sourcePath = @"C:\Windows\symbols\"; 
// Choose a destination for the copied files. 
string destinationPath = @"C:\TestFolder"; 


FileSystem.CopyDirectory(sourcePath, destinationPath, 
UIOption.AllDialogs); 
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如 何 : 写 入 文本 文件 (CH 编程 指南 ) 


以 下 示例 给 出 了 将 文本 写 入 文件 的 各 种 方法 。 前 两 个 示例 对 System.lO.File 类 使 用 
静态 便捷 方法 以 将 任何 IEnumerable<string> 的 每 个 元 素 和 一 个 字符 串 写 入 文本 文 

4, 示例 3 展示 了 在 写 入 文件 时 必须 分 别处 理 文本 的 每 一 行 时 ， 如 何 将 文本 添加 到 
文件 。 示例 1-3 覆盖 文件 中 的 所 有 现 有 内 容 ， 但 示例 4 展示 如 何 将 文本 追加 到 现 有 


Xt, 


这 些 示例 均 会 将 字符 串 文 本 写 入 文件 ， 但 是 你 更 有 可 能 需要 使 用 Format 方法 ， 此 
方法 具有 很 多 用 于 写 人 不 同类 型 值 的 控件 ， 包 括 在 字段 中 左右 对 齐 、 有 无 边 距 等 。 
还 可 以 使 用 C# 字符 串 内 插 功 能 。 


示例 


class WriteTextFile 


{ 


static void Main() 


t 


// These examples assume a "C:\Users\Public\TestFolder" fo: 
// You can modify the path if necessary. 


// Example #1: Write an array of strings to a file. 

// Create a string array that consists of three lines. 
string[] lines = { "First line", "Second line", "Third line 
// WriteAllLines creates a file, writes a collection of sti 
// and then closes the file. You do NOT need to call Flusl 
System.IO.File.WriteAllLines(Q"C:NUsersNPublicNTestFolderN 


// Example #2: Write one string to a text file. 

string text = "A class is the most powerful data type in C! 
"a class defines the data and behavior of tl 

// WriteAllText creates a file, writes the specified string 

// and then closes the file. You do NOT need to call Fli 

System.IO.File.WriteAllText(Q"C:NUsersNPublicNTestFolderNwW! 


// Example £3: Write only some strings in an array to a fi. 
// The using statement automatically flushes AND CLOSES the 
// IDisposable.Dispose on the stream object. 
// NOTE: do not use FileStream for text files because it wi 
// encodes the output as text. 
using (System.IO.StreamWwriter file = 

new System.IO.StreamWriter(Q"C:NUsersNPublicNTestFolde!: 


foreach (string line in lines) 


( 


于 ss 


// If the line doesn't contain the word 'Second', v 


if (!line.Contains("Second")) 


file.WriteLine(line); 


} 


// Example #4: Append new text to an existing file. 
// The using statement automatically flushes AND CLOSES the 


// IDisposable.Dispose on the stream object. 


using (System.IO.StreamWwriter file = 


new System.IO.StreamWriter(Q"C:NUsersNPublicNTestFolde! 


file.writeLine("Fourth line"); 


j 


//Output (to WriteLines.txt): 
47 First line 
// Second line 
47 Third line 


//Output (to WriteText.txt): 


// A class is the most powerful data type in CZ. 


//Output to WriteLines2.txt after Example #3: 
// First line 
// Third line 


//Output to WriteLines2.txt after Example #4: 
// First line 
// Third line 
// Fourth line 


Like a structui 





这 些 示例 均 会 将 字符 串 文本 写 入 文件 ， 但 是 你 更 有 可 能 需要 使 用 Format 方法 ， 此 
方法 暴 有 很 多 用 于 写 入 不 同类 型 值 的 控件 ， 包括 在 字段 中 左右 对 齐 、 有 无 边 距 等 。 


还 可 以 使 用 C# 字符 串 内 插 功 能 。 


可 靠 编 程 

以 下 情况 可 能 会 导致 异常 : 
。 文 件 已 存在 并 且 为 只 读 。 
e 路 径 名 可 能 太 长 。 

e A uU BEC. 
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C 编程 指南 


其 他 资源 
文件 系统 和 注册 表 (CH 编程 指南 ) 示例 : 将 集合 保存 到 应 用 程序 存储 


如 何 : 写 入 文本 文件 (C# 编程 指南 ) 


如 何 : 


读 取 文本 文件 中 的 内 容 (CH 编程 指南 ) 


此 示例 读 取 文本 文件 的 内 容 以 使 用 System.IO.File 选 件 类 的 静态 方法 ReadAllText 
和 ReadAllLines。 


有 关 使 用 StreamReader 的 示例 ， 请 参见 如 何 : 一 次 一 行 地 读 取 文 本 文件 (Visual 


CH, 


y 
Ef TER 


本 示例 的 文件 在 主题 如 何 : 写 人 文本 文件 (CH 编程 指南 ) 创建 。 


class ReadFromFile 


( 


static void Main() 


( 


// The files used in this example are created in the topic 
// How to: Write to a Text File. You can change the path ar 
// file name to substitute text files of your own. 


// Example #1 
// Read the file as one string. 
string text = System.1I0.File.ReadAllText(@"C: \Users\Public* 


// Display the file contents to the console. Variable text 
System.Console.WriteLine("Contents of WriteText.txt = {0}", 


// Example #2 

// Read each line of the file into a string array. Each ele 
// of the array is one line of the file. 

string[] lines = System.IO.File.ReadAllLines(Q"C:NUsersNPul 


// Display the file contents by using a foreach loop. 


System.Console.WriteLine("Contents of WriteLines2.txt = "), 
foreach (string line in lines) 
{ 


// Use a tab to indent each line of the file. 
Console.WriteLine("\t" + line); 


} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 








编译 代码 
将 代码 复制 并 粘贴 到 C# 控制 台 应 用 程序 。 


如 果 不 使 用 从 如 何 : 写 入 文本 文件 (CH 编程 指南 ) 的 文本 文件 ， 请 替换 为 您 计算 
机 上 的 参数 。ReadAlIText 和 ReadAllLines 使 用 适当 的 路 径 和 文件 名 。 


RISE RE 
以 下 情况 可 能 会 导致 异常 : 
。 文 件 不 在 指定 的 位 置 存在 或 不 存在 。 检 查 路 径 和 文件 名 的 拼写 。 
.NET Framework 安全 性 
不 要 依赖 文件 名 来 确定 文件 的 内 容 。 例 如 ， 文 件 myFile.cs 可 能 不 是 C# 源 文件 。 
请 参阅 
System.IO 


CH 编程 指南 
文件 系统 和 注册 表 (CH 编程 指南 ) 


如 何 : 一 次 一 行 地 读 取 文 本 文件 (Visual C£) 


本 示例 使 用 StreamReader 类 的 ReadLine 方法 将 文本 文件 的 内 容 读 取 (一 次 读 取 
—13) 到 字符 串 中 。 所 有 文本 行 都 保存 在 字符 串 line 中 并 显示 在 屏幕 上 。 


int counter = 0; 
string line; 
// Read the file and display it line by line. 
System.IO.StreamReader file - 

new System.IO.StreamReader(Q"c:Ntest.txt"); 
while((line - file.ReadLine()) !- null) 


System.Console.WriteLine (line); 
counter++; 


} 


file.Close(); 

System.Console.WriteLine("There were {0} lines.", counter); 
// Suspend the screen. 

System.Console.ReadLine(); 


编译 代码 

复制 该 代码 ， 并 将 其 粘贴 到 某 控制 台 应 用 程序 的 Main 方法 中 。 
将 "cMest.txt" 替换 为 实际 的 文件 名 。 

可 靠 编程 

以 下 情况 可 能 会 导致 异常 : 


。 该 文件 可 能 不 存在 。 


.NET Framework 安全 性 
不 要 根据 文件 的 名 称 来 判断 文件 的 内 容 。 例 如 ， 文 件 myFile.cs 可 能 不 是 CH 源 文 


请 参阅 


System.|O 
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如 何 : 一 次 一 行 地 读 取 文 本 文件 (Visual C#) 233 


如 何 : 在 注册 表 中 创建 注册 表 项 (Visual C) 


本 示例 将 值 对 “Name” 和 “lsabella” 添 加 到 当前 用 户 的 注册 表 中 的 注册 表 项 “Names” 之 


o 


Microsoft.Win32.RegistryKey key; 

key = Microsoft.Win32.Registry.CurrentUser .CreateSubKey("Names") ; 
key.SetValue("Name", "Isabella"); 

key.Close(); 


[E E 


编译 代码 
e 复制 该 代码 ， 并 将 其 粘贴 到 某 控制 台 应 用 程序 的 Main 方法 中 。 


e 将 Names 参数 蔡 换 为 直接 存在 于 注册 表 HKEY_CURRENT_USER 节点 下 的 
项 的 名 称 。 


。 将 _Nam_e 参数 蔡 换 为 直接 存在 于 “Names” 节 点 下 的 值 的 名 称 。 


可 靠 编程 


p ee 例如 ， 您 可 el ny. 
Software 项 ， 并 且 用 您 的 公司 的 名 称 创建 一 项 。 然 后 将 注册 表 值 添加 到 您 的 公司 的 
项 上 。 


以 下 情况 可 能 会 导致 异常 : 
e. 注册 表 项 的 名 称 为 空 。 
。 用 户 没有 创建 注册 表 项 的 权限 。 
。 注 册 表 项 名 称 超 过 255 个 字符 的 限制 。 
e. 注册 表 项 已 关闭 。 
e. 注册 表 项 是 只 读 的 。 


.NET Framework 安全 性 


与 将 数据 写 入 本 地 计算 机 (Microsoft. Win32.Registry.LocalMachine) 相 比 ， 将 数据 
写 入 用 户 文件 夹 (Microsoft.Win32.Registry.CurrentUser) 更 安全 。 


在 您 创建 建 注册 表 值 时 ， 需要 确定 如 果 该 值 已 存在 则 应 执行 的 操作 。 另 一 进程 (可 能 

是 恶意 进程 ) 可 能 已 创建 了 该 值 ， 并 拥有 对 该 值 的 访问 权 。 将 数据 放 太 注册 夫 什 
后 ， 其 他 进程 就 可 以 使 用 这 些 数 据 了 。 若 要 防止 出 现 这 种 情况 ， 请 使 用 
Overload:Microsoft.Win32.RegistryKey.GetValue 方法 。 如 果 注 册 表 项 不 存在 ， 
该 方法 将 返回 null 


0 访问 控制 列表 (ACL) 的 保护 ， 在 注册 表 中 以 纯 文 本 形式 存储 机 密 信 
息 (例如 密码 ) 也 不 安全 。 

请 参阅 

System.lO 

CH 编程 指南 

文件 系统 和 注册 表 (CH 编程 指南 ) 


Read, write and delete from the registry with C£ 


泛 型 (CH 编程 指南 ) 


2.0 版 CH 语言 和 公共 语言 运行 时 (CLR) 中 增加 了 泛 型 。 泛 型 将 类 型 参数 的 概念 引 
入 -NET Framework， 类 型 参数 使 得 设计 如 下 类 和 方法 成 为 可 能 : 这 些 类 和 方法 将 
一 个 或 多 个 类 型 的 指定 推迟 到 客户 端 代 码 声明 并 实例 化 该 类 或 方法 的 时 候 。 例 如 ， 

通过 使 用 泛 型 类 型 参数 T， 您 可 以 编写 其 他 客户 端 代码 能 够 使 用 的 单个 类 ， 而 不 致 
引入 运行 时 强制 转换 或 装 箱 操作 的 成 本 或 风险 ， 如 下 所 示 : 


// Declare the generic class. 
public class GenericList<T> 


void Add(T input) { } 


class TestGenericList 


{ 
private class ExampleClass { } 
static void Main() 
{ 
// Declare a list of type int. 
GenericList<int> list1 = new GenericList<int>(); 
// Declare a list of type string. 
GenericList<string> list2 = new GenericList<string>(); 
// Declare a list of type ExampleClass. 
GenericList<ExampleClass> list3 = new GenericList<ExampleC- 
} 
} 





沁 型 概述 


e 使 用 泛 型 类 型 可 以 最 大 限度 地 重用 代码 、 保 护 类 型 的 安全 以 及 提高 性 能 。 

e 泛 型 最 常见 的 用 途 是 创建 集合 类 。 

e .NET Framework 类 库 在 System.Collections.Generic 命名 空间 中 包含 几 个 新 
的 泛 型 集合 类 。 应 尽 可 能 地 使 用 这 些 类 来 代 蔡 普通 的 类 ， 如 
System.Collections 命名 空间 中 的 ArrayList。 

e 您 可 以 创建 自己 的 泛 型 接口 、 泛 型 类 、 泛 型 方法 、 泛 型 事件 和 泛 型 委托 。 

e 可 以 对 泛 型 类 进行 约束 以 访问 特定 数据 类 型 的 方法 。 

e 关于 泛 型 数据 类 型 中 使 用 的 类 型 的 信息 可 在 运行 时 通过 使 用 反射 获取 。 
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相关 章节 
有 关 更 多 信息 : 
e 泛 型 介绍 (CH 编程 指南 ) 
e 泛 型 的 优点 (CH 编程 指南 ) 
e 泛 型 类 型 参数 (CH 编程 指南 ) 
e 类 型 参数 的 约束 (CH 编程 指南 ) 
泛 型 类 (CH 编程 指南 ) 
e 泛 型 接口 (CH 编程 指南 ) 
e 泛 型 方法 (CH 编程 指南 ) 
e 泛 型 委托 (CH 编程 指南 ) 
泛 型 代码 中 的 默认 关键 字 (CH 编程 指南 ) 
e C++ 模板 和 CH 泛 型 之 间 的 区 别 (CH 编程 指南 ) 
泛 型 和 反射 (CH 编程 指南 ) 
运行 时 中 的 泛 型 (CH 编程 指南 ) 
e .NET Framework 类 库 中 的 泛 型 (CH 编程 指南 ) 


= yn dp 
C# iE 5 AUE 

有 关 更 多 信息 ， 请 参见 C# 语言 规范 。 
请 参阅 
System.Collections.Generic 

CH 编程 指南 

类 型 (C# 编程 指南 ) 

<typeparam> (C£ 编程 指南 ) 
<typeparamref> (C£ 编程 指南 ) 


泛 型 (CH 编程 指南 ) 


泛 型 介绍 (CH 编程 指 两 ) 


泛 型 类 和 泛 型 方法 同时 具备 可 重用 性 、 类 型 安全 和 效率 ， 这 是 非 泛 型 类 和 非 泛 型 方 
法 无 法 具 各 的 。 泛 型 通常 用 与 集合 以 及 作用 于 集合 的 方法 一 起 使 用 。.NET 
Framework 2.0 版 类 库 提供 一 个 新 的 命名 空间 System.Collections.Generic, Kr 
包含 几 个 新 的 基于 泛 型 的 集合 类 。 建 议 面向 .NET Framework 2.0 及 更 高 版 本 的 所 
有 应 用 程序 都 使 用 新 的 泛 型 集合 类 ， 而 不 要 使 用 旧 的 非 泛 型 集合 类 如 ArrayList。 有 
关 更 多 信息 ， 请 参见 NET Framework 类 库 中 的 泛 型 (CH 编程 指南 ) o 


当然 ， 也 可 以 创建 自 定 义 泛 型 类 型 和 方法 ， 以 提供 自己 的 通用 解决 方案 ， 设 计 类 型 
安全 的 高 效 模式 。 下 面 的 代码 示例 演示 一 个 用 于 演示 用 途 的 简单 泛 型 链接 列表 类 。 
(大 多 数 情况 下 ， 应 使 用 .NET Framework 类 库 提供 的 List<T> 类 ， 而 不 是 自行 创 
EX, ) 在 通常 使 用 具体 类 型 来 指示 列表 中 存储 的 项 的 类 型 的 场合 ， 可 使 用 类 型 参 
数 TT 其 使 用 方法 如 下 : 


e 在 AddHead 方法 中 作为 方法 参数 的 类 型 。 
e 在 Node REX HEX BHA GetNext 和 Data 属性 的 返回 类 型 。 
e 在 启 套 类 中 作为 私有 成 员 数 据 的 类 型 。 


XE, T 可 用 于 Node 府 套 类 。 如 果 使 用 具体 类 型 实例 化 GenericList<T> (例如 ， 
作为 GenericList<int>) ， 则 所 有 的 T 都 将 被 替换 为 int 


// type parameter T in angle brackets 
public class GenericList<T> 


// The nested class is also generic on T. 
private class Node 
{ 
// T used in non-generic constructor. 
public Node(T t) 
{ 
next = null; 
data = t; 
} 


private Node next; 

public Node Next 

{ 
get { return next; } 
set { next = value; } 


} 


// T as private member data type. 
private T data; 


// T as return type of property. 
public T Data 


get { return data; } 
set { data = value; } 


} 
private Node head; 


// constructor 
public GenericList() 


{ 
} 


head = null; 


// T as method parameter type: 
public void AddHead(T t) 


{ 
Node n = new Node(t); 
n.Next = head; 
head = n; 
} 
public IEnumerator<T> GetEnumerator() 
{ 
Node current = head; 
while (current != null) 
yield return current.Data; 
current = current. Next; 
} 
} 


下 面 的 代码 示例 演示 客户 端 代 码 如 何 使 用 泛 型 GenericList<T> 类 来 创建 整数 列表 。 
e am m 即 可 方便 地 修改 下 面 的 代码 示例 ， 创 建 字 符 串 或 任何 其 他 自 定 
义 类 型 的 列表 : 


class TestGenericList 


( 


static void Main() 


{ 
// int is the type argument 


GenericList<int> list = new GenericList<int>()j; 


for (int x = 05 x < 10; 3E) 


{ 
} 


foreach (int i in list) 


t 
} 


System.Console.WriteLine("NnDone"); 


list.AddHead(x); 


System.Console.write(i +" "); 


请 参阅 
System.Collections.Generic 
CH 编程 指南 

泛 型 (CH 编程 指南 ) 


泛 型 的 优点 (CH 编程 指南 ) 


在 公共 语言 运行 时 和 CH 语言 的 早期 版 本 中 ， 通 用 化 是 通过 在 类 型 与 通用 基 类 型 
Object 之 间 进 行 强制 转换 来 实现 的 ， 泛 型 提供 了 针对 这 种 限制 的 解决 方案 。 通 过 创 
建 泛 型 类 ， 您 可 以 创建 一 个 在 编译 时 类 型 安全 的 集合 。 


使 用 非 泛 型 集合 类 的 限制 可 以 通过 编写 一 小 段 程序 来 演示 ， 该 程序 使 用 NET 
Framework 类 库 中 的 ArrayList 集合 类 。 ArrayList 是 一 个 使 用 起 来 非常 方便 的 集合 


米 


类 ， 无 需 进行 修改 即 可 用 来 存储 任何 引用 或 值 类 型 。 


// The .NET Framework 1.1 way to create a list: 
System.Collections.ArrayList list1 = new System.Collections.ArrayL: 
listi.Add(3); 

list1.Add(105); 


System.Collections.ArrayList list2 = new System.Collections.ArrayL: 
list2.Add("It is raining in Redmond."); 
list2.Add("It is snowing in the mountains."); 


= €— 


但 这 种 方便 是 需要 付出 代价 的 。 添 加 到 ArrayList 中 的 任何 引用 或 值 类 型 都 将 隐 式 
地 向 上 强制 转换 为 Object。 如 果 项 是 值 类 型 ， 则 必须 在 将 其 添加 到 列表 中 时 进行 装 
箱 操 作 ， 在 检索 时 进行 取消 装 箱 操 作 。 强 制 转换 以 及 装 箱 和 取消 装 箱 操作 都 会 降低 
性 能 ; 在 必须 对 大 型 集合 进行 循环 访问 的 情况 下 ， 装 箱 和 取消 装 箱 的 影响 非常 明 


go 
dbo 


另 一 个 限制 是 缺少 编译 时 类 型 检查 ; AA ArrayList 会 特 所 有 项 都 强制 转换 为 
Object， 所 以 在 编译 时 无 法 防止 客户 端 代 码 执 行 类 似 如 下 的 操作 : 





System.Collections.ArrayList list = new System.Collections.ArrayLi: 
// Add an integer to the list. 

list.Add(3); 

// Add a string to the list. This will compile, but may cause an e! 
list.Add("It is raining in Redmond."); 


int t = 0; 
// This causes an InvalidCastException to be returned. 
foreach (int x in list) 


{ 


t += X; 





IIS 


尽管 将 字符 串 和 ints 组 合 在 一 个 ArrayList 中 的 做 法 在 创建 异类 集合 时 是 完全 可 接 
受 的 ， 并 且 有 时 需要 有 意 为 之 ， 但 这 种 做 法 很 可 能 产生 编程 错误 ， 并 且 直 到 运行 时 


才能 检测 到 此 错误 。 


在 CH 语言 的 1.0 和 1.1 版 本 中 ， 只 能 通过 编写 自己 的 特定 于 类 型 的 集合 来 避免 
.NET Framework 基 类 库 集 合 类 中 的 通用 代码 的 危险 。 当 然 ， 由 于 此 类 不 可 对 多 个 
数据 类 型 重用 ， 因 此 将 丧失 通用 化 的 优点 ， 并 且 您 必须 对 要 存储 的 每 个 类 型 重新 编 


ArrayList 和 其 他 相似 类 真正 需要 的 是 : 客户 端 代码 基于 每 个 实例 指定 这 些 类 要 使 用 
的 具体 数据 类 型 的 方式 。 这 样 将 不 再 需要 向 上 强制 转换 为 下 System.Object， 同 
时 ， 也 使 得 编译 器 可 以 进行 类 型 检查 。 换 句 话说 ，ArrayList 需要 一 个 类 型 参数 。 这 
正 是 泛 型 所 能 提供 的 。 在 N:System.Collections.Generic 命名 空间 的 泛 型 
List<T> 集合 中 ， 向 集合 添加 项 的 操作 类 似 于 以 下 形式 : 


// The .NET Framework 2.0 way to create a list 


List<int> list1 = new List<int>(); 


// No boxing, no casting: 
listi.Add(3); 


// Compile-time error: 
// listi.Add("It is raining in Redmond."); 


对 于 客户 端 代码 ， 与 ArrayList THEE, (FA List<T> 时 添加 的 唯一 语法 是 声明 和 实例 
化 中 的 类 型 参数 。 虽 然 这 种 方式 稍微 增加 了 编码 的 复杂 性 ， 但 好 义 是 您 可 以 创建 一 
个 比 ArrayList 更 安全 并 且 速 度 更 快 的 列表 ， 对 于 列表 项 是 值 类 型 的 情况 尤为 如 

此 。 


请 参阅 

System.Collections.Generic 

C# 编程 指南 

泛 型 介绍 (CH 编程 指南 ) 

装 箱 和 取消 装 箱 (CH 编程 指南 ) 

Collections Best Practices (有 关 集 合 的 最 佳 做 法 ) 


沁 型 类 型 参数 (CH 编程 指责) 


在 泛 型 类 型 或 方法 定义 中 ， 类 型 参数 是 客户 端 在 实例 化 泛 型 类 型 的 变量 时 指定 的 特 
定 类 型 的 占 位 符 。 泛 型 类 (如 泛 型 介绍 (CH 编程 指南 ) 中 列 出 的 
GenericList<T>) 不 可 以 像 这 样 使 用 ， 因 为 它 实 际 上 并 不 是 一 个 类 型 ， 而 更 像 是 一 
个 类 型 的 蓝图 。 若 要 使 用 GenericList<T>， 客 户 端 代码 必须 通过 指定 尖 括 号 中 的 类 
型 参数 来 声明 和 实例 化 构造 类 型 。 此 特定 类 的 类 型 参数 可 以 是 编译 器 识别 的 任何 类 
型 。 可 以 创建 任意 数目 的 构造 类 型 灾 例 ， 每 个 实例 使 用 不 同 的 类 型 参数 ， 如 下 所 
示 : 


GenericList«float» listi = new GenericList<float>(); 
GenericList<ExampleClass> list2 = new GenericList«ExampleClass»(); 
GenericList<ExampleStruct> list3 = new GenericList<ExampleStruct>(_ 





在 每 个 GenericList<T> 实例 中 ， 类 中 出 现 的 每 个 T 都 会 在 运行 时 蔡 换 为 相应 的 类 
型 参数 。 通 过 这 种 替换 方式 ， 我 们 使 用 一 个 类 定义 创建 了 三 个 独立 的 类 型 安全 的 有 
效 对 象 。 有 关 CLR 如 何 执行 此 替换 的 更 多 信息 ， 请 参见 运行 时 中 的 泛 型 (CH 编程 
指南 ) 。 


类 型 参数 命名 准则 


e 务必 使 用 描述 性 名 称 命 名 泛 型 类 型 参数 ， 除 非 单 个 字母 名 称 完全 可 以 让 人 了 解 
它 表 示 的 含义 ， 而 描述 性 名 称 不 会 有 更 多 的 意义 。 


NI 


public interface ISessionChannel&lt;TSession&gt; { /*...*/ } 
public delegate TOutput Converter&lt;TInput, TOutput&gt;(TInput 
public class List&lt;T&gt; { /*...*/ } 


E NE = 3 
。 考虑 使 用 T 作为 具有 单个 字母 类 型 参数 的 类 型 的 类 型 参数 名 。 





public int IComparer&lt;T&gt;() { return 0; } 
public delegate bool Predicate&lt;T&gt;(T item); 
public struct Nullable&lt;T&gt; where T : struct ( /*...*/ } 


e 务必 将 “T" 作 为 描述 性 类 型 参数 名 的 前 级 。 


public interface ISessionChannel&lt;TSession&gt; 


t 
} 


TSession Session { get; } 


e 考虑 在 参数 名 中 指示 对 此 类 型 参数 的 约束 。 例 如 ， 可 以 将 带 有 ISession 约束 的 
参数 命名 为 TSession。 


请 参阅 
System.Collections.Generic 
C# 编程 指南 


A (CH 编程 指南 ) 
C++ 模板 和 CH 泛 型 之 间 的 区 别 (CH 编程 指南 ) 


类 型 参数 的 约束 (CH 编程 指南 ) 


在 定义 泛 型 类 时 ， 可 以 对 客户 端 代码 能 够 在 实例 化 类 时 用 于 类 型 参数 的 类 型 种 类 施 
加 限制 。 如 果 客 户 端 代 码 党 试 使 用 某 个 约束 所 不 允许 的 类 型 来 实例 化 类 ， 则 会 产生 
编译 时 错误 。 这 些 限 制 称 为 约束 。 约 束 是 使 用 where 上 下 文 关键 字 指 定 的 。 下 表 
列 出 了 六 种 类 型 的 约束 : 


约束 说 明 
T: 类 型 参数 必须 是 值 类 型 。 可 以 指定 除 Nullable 以 外 的 任何 值 类 型 。 有 
构 关 更 多 信息 ， 请 参见 使 用 可 以 为 null 的 类 型 (CH 编程 指南 ) o 
rox ”类 型 参数 必须 是 引用 类 型 ; 这 一 点 也 适用 于 任何 类 、 接 口 、 委 托 或 数 
Ee 
T: X USARA TEANA ERA. 45 R 
new() | &H, new() 约束 必须 最 后 指定 。 
Jp 3 
类 类 型 参数 必须 是 指定 的 基 类 或 派生 自 指 定 的 基 类 。 
> 
nm 类 型 参数 必须 是 指定 的 接口 或 实现 指定 的 接口 。 可 以 指定 多 个 接口 约 
束 。 约 束 接口 也 可 以 是 泛 型 的 。 
名 称 > 
T.U AT 提供 的 类 型 参数 必须 是 为 U 提供 的 参数 或 派生 自 为 U 提供 的 参 


数 。 


使 用 约束 的 原因 


如 果 要 检查 泛 型 列表 中 的 某 个 项 以 确定 它 是 否 有 效 ， 或 者 将 它 与 其 他 某 个 项 进行 比 
较 ， 则 编译 器 必须 在 一 定 程 度 上 保证 它 需要 调用 的 运算 符 或 方法 将 受到 客户 端 代 码 
可 能 指定 的 任何 类 型 参数 的 支持 。 这 种 保证 是 通过 对 泛 型 类 定义 应 用 一 个 或 多 个 约 
束 获 得 的 。 例 如 ， 基 类 约束 告诉 编译 器 : 仅 此 类 型 的 对 象 或 从 此 类 型 派生 的 对 象 才 
可 用 作 类 型 参数 。 一 旦 编译 器 有 了 这 个 保证 ， 它 就 能 够 允许 在 泛 型 类 中 调用 该 类 型 
的 方法 。 约 束 是 使 用 上 下 文 关 键 字 where 应 用 的 。 下 面 的 代码 示例 演示 可 通过 应 
用 基 类 约束 添加 到 GenericList<T> 类 (在 泛 型 介绍 (CH 编程 指南 ) 中 ) 的 功能 。 


public class Employee 


private string name; 
private int id; 


public Employee(string s, int i) 


( 


name = s; 


j 


public string Name 


( 


j 


public int ID 


( 


get { return name; } 
set { name = value; } 


get { return id; } 
set { id = value; } 


public class GenericList<T> where T : 


{ 


private class Node 


i 


} 


private Node next; 
private T data; 


public Node(T t) 


( 


next 


data 


j 


null; 
t; 


public Node Next 


( 


get { return next; } 
set { next = value; } 


j 


public T Data 


{ 


get { return data; } 
set { data = value; } 


private Node head; 


public GenericList() //constructor 


{ 
} 


head = null; 


public void AddHead(T t) 


( 


Node n 
n.Next 


new Node(t); 
head; 


Employee 


head = n; 


} 
public IEnumerator<T> GetEnumerator() 
{ 
Node current = head; 
while (current != null) 
{ 
yield return current.Data; 
current - current.Next; 
} 
} 
public T FindFirstOccurrence(string s) 
{ 
Node current = head; 
T t = null; 
while (current != null) 
{ 
//The constraint enables access to the Name property. 
if (current.Data.Name == s) 
{ 
t = current.Data; 
break; 
} 
else 
{ 
current = current. Next; 
} 
} 
return t; 
} 


} 
UUO 
约束 使 得 泛 型 类 能 够 使 用 Employee.Name 属性 ， 因 为 类 型 为 T 的 所 有 项 都 保证 是 
Employee 对 象 或 从 Employee 继承 的 对 象 。 

可 以 对 同一 类 型 参数 应 用 多 个 约束 ， 并 且 约 束 自身 可 以 是 泛 型 类 型 ， 如 下 所 示 : 


class EmployeeList<T> where T : Employee, IEmployee, System.ICompa! 
{ 


} 


«| — 


UU yne 








通过 约束 类 型 参数 ， 可 以 增加 约束 类 型 及 其 继承 层次 结构 中 的 所 有 类 型 所 支持 的 允 
许 操作 和 方法 调用 的 数量 。 因 此 ， 在 设计 泛 型 类 或 方法 时 ， 如 果 要 对 泛 型 成 员 执 行 
除 简单 赋值 之 外 的 任何 操作 或 调用 System.Object 不 支持 的 任何 方法 ， 您 将 需要 
对 该 类 型 参数 应 用 约束 。 


在 应 用 where T: class 约束 时 ， 避 免 对 类 型 参数 使 用 == 和 != 运算 符 ， 因 为 这 些 
运算 符 仅 测试 引用 同一 性 而 不 测试 值 相 等 性 。 即 使 在 用 作 参 数 的 类 型 中 重 载 这 些 运 
算 符 也 是 如 此 。 下 面 的 代码 说 明了 这 一 点 ; 即使 String 类 重 载 == 运算 符 ， 输 出 也 
为 false。 


public static void OpTest<T>(T s, T t) where T : class 
1 


System.Console.WriteLine(s -- t); 
} 
static void Main() 
{ 
string si = "target"; 
System.Text.StringBuilder sb = new System.Text.StringBuilder ("1 
string s2 = sb.ToString(); 
OpTest<string>(s1, s2); 
} 


El = 
这 种 情况 的 原因 在 于 ， 编 译 器 在 编译 时 仅 知道 T 是 引用 类 型 ， 因 此 必须 使 用 对 所 有 


引用 类 型 都 有 效 的 默认 运算 符 。 如 果 必 须 测 试 值 相 等 性 ， 建 议 的 方法 是 同时 应 用 
where T : IComparable«T» 约束 ， 并 在 将 用 于 构造 泛 型 类 的 任何 类 中 实现 该 接口 。 


约束 多 个 参数 


可 以 对 多 个 参数 应 用 约束 ， 并 对 一 个 参数 应 用 多 个 约束 ， 如 下 面 的 示例 所 示 : 





class Base ( ) 
class Test<T, U> 
where U : struct 
where T : Base, new() { } 


未 绑 定 的 类 型 参数 
没有 约束 的 类 型 参数 (如 公共 类 SampleClass<T>f 人 HAT) 称 为 未 绑 定 的 类 型 参 
数 。 未 绑 定 的 类 类 型 参数 具有 以 下 规则 : 

e 不 能 使 用 != 和 == 运算 符 ， 因 为 无 法 保证 具体 类 型 参数 能 支持 这 些 运算 符 。 


e 可 以 在 它们 与 System.Object 之 间 来 回转 换 ， 或 将 它们 显 式 转换 为 任何 接口 
类 型 。 


e 可 以 将 它们 与 null 进行 比较 。 将 未 绑 定 的 参数 与 null 进行 比较 时 ， 如 果 类 型 
参数 为 值 类 型 ， 则 该 比较 将 始终 返回 false. 


作为 约束 的 类 型 参数 
将 泛 型 类 型 参数 作为 约束 使 用 ， 在 具有 自己 类 型 参数 的 成 员 画 数 必须 将 该 参数 约束 
为 包含 类 型 的 类 型 参数 时 非常 有 用 ， 如 下 示例 所 示 : 

class List<T> 


void Add<U>(List<U> items) where U : T (/*...*/) 


在 上 面 的 示例 中 ,本 在 Add 方法 的 上 下 文中 是 一 个 类 型 约束 ， 而 在 List 类 的 上 下 
文中 是 一 个 未 绑 定 的 类 型 参数 。 


类 型 参数 还 可 在 泛 型 类 定义 中 用 作 约 束 。 请 注意 ， 必 须 在 尖 括 号 中 声明 此 类 型 参数 
与 任何 其 他 类 型 的 参数 : 


//Type parameter V is used as a type constraint. 
public class SampleClass<T, U, V» where T : V ( 9 


泛 型 类 的 类 型 参数 约束 的 作用 非常 有 限 ， 因 为 编译 器 除了 假设 类 型 参数 派生 自 
System.Object 以 外 ， 不 会 做 其 他 任何 假设 。 在 希望 强制 两 个 类 型 参数 之 间 的 继承 
关系 的 情况 下 ， 可 对 泛 型 类 使 用 参数 类 型 约束 。 


请 参阅 
System.Collections.Generic 
C# 编程 指南 

泛 型 介绍 (C# 编程 指南 ) 
泛 型 类 (CH 编程 指南 ) 
new 约束 (CH 参考 ) 


泛 型 类 (CH 编程 指南 ) 


泛 型 类 封装 不 是 特定 于 具体 数据 类 型 的 操作 。 泛 型 类 最 常用 于 集合 ， 如 链接 列表 、 
哈 希 表 、 堆 栈 、 队 列 、 树 等 。 像 从 集合 中 添加 和 移 除 项 这 样 的 操作 都 以 大 体 上 相同 
的 方式 执行 ， 和 与 所 存储 数据 的 类 型 无 关 。 


对 于 大 多 数 需要 集合 类 的 方案 ， 推 荐 的 方法 是 使 用 .NET Framework 类 库 中 所 提供 
的 类 。 有 关 使 用 这 些 类 的 更 多 信息 ， 请 参见 .NET Framework 类 库 中 的 泛 型 (CHA 
程 指南 ) 。 
一 般 情况 下 ， 创 建 泛 型 类 的 过 程 为 : 从 一 个 现 有 的 具体 类 开始 ， 逐 一 将 每 个 类 型 更 
改 为 类 型 参数 ， 直 至 达到 通用 化 和 可 用 性 的 最 佳 平 衡 。 创 建 您 自己 的 泛 型 类 时 ， 需 
要 特别 注意 以 下 事项 : 

e 将 哪些 类 型 通用 化 为 类 型 参数 。 
通常 ， 能 够 参数 化 的 类 型 越 多 ， 代 码 就 会 变 得 越 灵 活 ， 重 用 性 就 越 好 。 但 是 ， 
太 多 的 通用 化 会 使 其 他 开发 人 员 难 以 阅读 或 理解 代码 。 
如 果 存 在 约束 ， 应 对 类 型 参数 应 用 什么 约束 (请 参见 类 型 参数 的 约束 (CH 2 
程 指南 ) ) 。 
一 条 有 用 的 规则 是 ， 上 应 用 尽 可 能 最 多 的 约束 ， 但 仍 使 您 能 够 处 理 必 须 处 理 的 类 
型 。 例 如 ， 如 果 您 知道 您 的 泛 型 类 仅 用 于 引用 类 型 ， 则 应 用 类 约束 。 这 可 以 防 
止 您 的 类 被 意外 地 用 于 值 类 型 ， 并 人 允许 您 对 丁 使 用 as 运算 符 以 及 检查 空 值 。 
e 是 否 将 泛 型 行为 分 解 为 基 类 和 子 类 。 


由 于 泛 型 类 可 以 作为 基 类 使 用 ， 此 处 适用 的 设计 注意 事项 与 非 泛 型 类 相同 。 请 
参见 本 主题 后 面 有 关 从 泛 型 基 类 继承 的 规则 。 


e 是 否 实现 一 个 或 多 个 泛 型 接口 。 
例如 ， 如 果 您 设计 一 个 类 ， 该 类 将 用 于 创建 基于 泛 型 的 集合 中 的 项 ， 则 可 能 必 
须 实现 一 个 接口 ， 如 IComparable<T>， 其 中 T 是 您 的 类 的 类 型 。 


有 关 简 单 泛 型 类 的 示例 ， 请 参见 泛 型 介绍 (CH 编程 指南 ) o 


类 型 参数 和 约束 的 规则 对 于 泛 型 类 行为 有 几 方 面 的 含义 ， 特 别 是 关于 继承 和 成 员 可 
访问 性 。 您 应 当先 理解 一 些 术 语 ， 然 后 再 继续 进行 。 对 于 泛 型 类 Node<T>， 客 户 
端 代码 可 通过 指定 类 型 参数 来 引用 该 类 ， 以 便 创建 封闭 式 构 造 类 型 (Node<int>)。 
或 者 可 以 让 类 型 参数 处 于 未 指定 状态 (例如 在 指定 泛 型 基 类 时 ) 以 创建 开放 式 构 造 
类 型 (Node<T>)。 泛 型 类 可 以 从 具体 的 、 封 闭 式 构 造 或 开放 式 构 造 基 类 继承 : 


class BaseNode ( ) 
class BaseNodeGeneric<T> { } 


// concrete type 
class NodeConcrete<T> : BaseNode { } 


//closed constructed type 
class NodeClosed<T> : BaseNodeGeneric<int> { } 


//open constructed type 
class NodeOpen<T> : BaseNodeGeneric<T> { } 


非 泛 型 类 〈 换 名 话说 ， 即 具体 类 ) 可 以 从 封闭 式 构造 基 类 继承 ， 但 无 法 从 开放 式 构 
p ON AES 因为 在 运行 时 客户 端 代码 无 法 提供 实例 化 基 类 所 需 的 类 型 参 


//No error 
class Node1 : BaseNodeGeneric<int> { } 


//Generates an error 
//class Node2 : BaseNodeGeneric<T> {} 


//Generates an error 
//class Node3 : T {} 


型 变量 ， or 


class BaseNodeMultiple<T, U> { } 


//No error 
class Node4<T> : BaseNodeMultiple<T, int» ( } 


//No error 
class Node5<T, U» : BaseNodeMultiple<T, U» { } 


//Generates an error 
//class Node6<T> : BaseNodeMultiple<T, U» {} 


从 开放 式 构造 类 型 继承 的 泛 型 类 必须 指定 约束 ， 这 些 约束 是 基 类 型 约束 的 超 集 或 暗 
示 基 类 型 约束 : 


class NodeItem<T> where T : System.IComparable<T>, new() { } 
class SpecialNodeItem<T> : NodeItem<T> where T : System. IComparable 


«| x 








泛 型 类 型 可 以 使 用 多 个 类 型 参数 和 约束 ， 如 下 所 示 : 


class SuperKeyType<K, V, U> 
where U : System. IComparable<U> 
where V : new() 


d } 


开放 式 构造 类 型 和 封闭 式 构造 类 型 可 以 用 作 方 法 参数 : 


void Swap<T>(List<T> listi, List<T> list2) 


//code to swap items 


} 
void Swap(List<int> listi, List<int> list2) 


//code to swap items 


如 果 某 个 泛 型 类 实现 了 接口 ， 则 可 以 将 该 类 的 所 有 实例 强制 转换 为 该 接口 。 


泛 型 类 是 不 变 的 。 也 就 是 说 ， 如 果 输 入 参数 指定 List<BaseClass>， 则 当 您 党 试 提 
供 List<DerivedClass> 时 ， 将 会 发 生 编 译 时 错误 。 


请 参阅 

System.Collections.Generic 

C# 编程 指南 

泛 型 (C# 编程 指南 ) 

Saving the State of Enumerators (保存 枚 举 器 的 状态 ) 

An Inheritance Puzzle, Part One (一 个 继承 难题 ， 第 一 部 分 ) 


泛 型 接口 (CH 编程 指责) 


为 泛 型 集合 类 或 表示 集合 中 项 的 泛 型 类 定义 接口 通常 很 有 用 。 对 于 泛 型 类 ， 使 用 泛 
型 接口 十 分 可 取 ， 例 如 使 用 IComparable<T> 而 不 使 用 IComparable， 这 样 可 以 避 
免 值 类 型 的 装 箱 和 取消 装 箱 操作 。.NET Framework 类 库 定义 了 若干 泛 型 接口 ， 以 
用 于 System.Collections.Generic 命名 空间 中 的 集合 类 。 


将 接口 指定 为 类 型 参数 的 约束 时 ， 只 能 使 用 实现 此 接口 的 类 型 。 下 面 的 代码 示例 显 
示 从 SortedList<T> 类 派生 的 GenericList<T> 类 。 有 关 更 多 信息 ， 请 参见 泛 型 介 
绍 (CH 编程 指南 ) o SortedList<T> 添加 约束 where T : IComparable«T», ix Rf 
使 SortedList<T> 中 的 BubbleSort 方法 能 够 对 列表 元 素 使 用 泛 型 CompareTo A 
法 。 在 此 示例 中 ， 列 表 元 素 为 简单 类 ， 即 实现 Person 的 IComparable<Person>。 


//Type parameter T in angle brackets. 
public class GenericList<T> : System.Collections.Generic.IEnumerab: 
1 

protected Node head; 

protected Node current - null; 


// Nested class is also generic on T 
protected class Node 
{ 
public Node next; 
private T data; //T as private member datatype 


public Node(T t) //T used in non-generic constructor 
{ 
next 
data 


null; 
t; 


} 


public Node Next 
{ 


get { return next; } 
set { next = value; } 


} 
public T Data //T as return type of property 


{ 
get { return data; } 


set { data = value; } 
} 
public GenericList() //constructor 


head - null; 


j 


public void AddHead(T t) //T as method parameter type 
f 


Node n - new Node(t); 
n.Next - head; 
head = n; 


} 


// Implementation of the iterator 
public System.Collections.Generic.IEnumerator«T» GetEnumerator | 
{ 
Node current = head; 
while (current != null) 
{ 
yield return current.Data; 
current = current.Next; 


} 


// IEnumerable<T> inherits from IEnumerable, therefore this cl: 
// must implement both the generic and non-generic versions of 
// GetEnumerator. In most cases, the non-generic method can 

// simply call the generic method. 
System.Collections.IEnumerator System.Collections.IEnumerable.t( 


E 
} 


return GetEnumerator(); 


public class SortedList<T> : GenericList<T> where T : System.IComp: 


( 


// A simple, unoptimized sort algorithm that 
// orders list elements from lowest to highest: 


public void BubbleSort() 


{ 
if (null -- head || null == head.Next) 
{ 
return; 
j 
bool swapped; 
do 
{ 


Node previous = null; 
Node current = head; 
swapped = false; 


while (current.next != null) 

{ 
// Because we need to call this method, the Sortec 
// Class is constrained on IEnumerable<T> 
if (current.Data.CompareTo(current.next.Data) > 0) 


{ 


Node tmp = current.next; 
current.next - current.next.next; 
tmp.next - current; 


if (previous -- null) 
{ 
head = tmp; 
} 
else 
{ 


previous.next = tmp; 


} 
previous = tmp; 
swapped = true; 


} 
else 
i . 
previous = current, 
current = current.next; 
} 


} 
} while (swapped); 


} 


// A simple class that implements IComparable<T> using itself as tl 
// type argument. This is a common design pattern in objects that 
// are stored in generic lists. 
public class Person : System.IComparable«Person» 
{ 

string name; 

int age; 


public Person(string s, int i) 
t 

name - s; 

age - i; 


} 


// This will cause list elements to be sorted on age values. 
public int CompareTo(Person p) 


{ 
return age - p.age; 
} 
public override string ToString() 
{ 
return name + ":" + age; 
} 


// Must implement Equals. 
public bool Equals(Person p) 


( 


return (this.age -- p.age); 


class Program 


static void Main() 


} 
} 
E 
{ 
j 


//Declare and instantiate a new generic SortedList class. 
//Person is the type argument. 
SortedList«Person» list = new SortedList<Person>(); 


//Create name and age values to initialize Person objects. 
string[] names - new string[] 


"Franscoise", 
"pgs 

"n Bi 2 
"Sandra", 
"Gunnar", 
"Alok" ; 
"Hiroyuki", 
"Maria", 
"Alessandro", 
"Raul" 


int[] ages = new int[] ( 45, 19, 28, 23, 18, 9, 108, 72, 3 


//Populate the list. 
for (int x = 0; x < 10; X++) 


{ 
} 


//Print out unsorted list. 
foreach (Person p in list) 


{ 
} 


System.Console.WriteLine("Done with unsorted list"); 


list.AddHead(new Person(names[x], ages[x])); 


System.Console.WriteLine(p.ToString()); 


//Sort the list. 
list.BubbleSort(); 


//Print out sorted list. 
foreach (Person p in list) 


{ 
} 


System.Console.WriteLine("Done with sorted list"); 


System.Console.WriteLine(p.ToString()); 


«| um 








可 将 多 重 接口 指定 为 单个 类 型 上 的 约束 ， 如 下 所 示 : 


class Stack<T> where T : System.IComparable<T>, IEnumerable<T> 
{ 
j 


一 个 接口 可 定义 多 个 类 型 参数 ， 如 下 所 示 : 


interface IDictionary«K, V» 
{ 
j 


适用 于 类 的 继承 规则 同样 适用 于 接口 : 


interface IMonth<T> ( } 


interface IJanuary : IMonth<int> { } //No error 
interface IFebruary<T> : IMonth<int> { ) //No error 
interface IMarch<T> : IMonth<T> ( } //No error 


//interface IApril<T> : IMonth<T, U> () //Error 


如 果 泛 型 接口 为 逆 变 的 ， 即 信使 用 其 类 型 参数 作为 返回 值 ， 则 此 泛 型 接口 可 以 从 非 
泛 型 接口 继承 。 在 .NET Framework 类 库 中 ，IEnumerable<T> M IEnumerable 继 
承 ， 因 为 IEnumerable<T> 只 在 GetEnumerator 的 返回 值 和 Current 属性 getter 中 
使 用 T。 


具体 类 可 以 实现 已 关闭 的 构造 接口 ， 如 下 所 示 : 
interface IBaseInterface<T> ( } 
class SampleClass : IBaseInterface<string> { } 


只 要 类 参数 列表 提供 了 接口 必需 的 所 有 参数 ， 泛 型 类 便 可 以 实现 泛 型 接口 或 已 关闭 
的 构造 接口 ， 如 下 所 示 : 


interface IBaseInterface1<T> { } 
interface IBaseInterface2<T, U> { } 


class SampleClassi<T> : IBaseInterfacei<T> { } //No error 
class SampleClass2<T> : IBaseInterface2<T, string» { } //No error 


4 — — — Bi 
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TIE。 泛 型 结构 或 泛 型 接口 中 的 方法 ， 控 制 方法 重 载 的 规则 相同 。 有 关 更 多 
信息 ， 请 参见 见 泛 型 方法 (C# 编程 指南 ) 。 
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泛 型 方法 (CH 编程 指南 ) 
泛 型 方法 是 使 用 类 型 参数 声明 的 方法 ， 如 下 所 示 : 


static void Swap<T>(ref T lhs, ref T rhs) 


{ 
T temp; 
temp = lhs; 
lhs = rhs; 
rhs = temp; 
j 


下 面 的 代码 示例 演示 一 种 使 用 int 作为 类 型 参数 的 方法 调用 方式 : 


public static void TestSwap() 


Swap<int>(ref a, ref b); 
System.Console.WriteLine(a + " " + b); 


也 可 以 省 略 类 型 参数 ， 编 译 器 将 推断 出 该 参数 。 下 面 对 Swap 的 调用 等 效 于 前 面 的 
调用 : 


Swap(ref a, ref b); 


相同 的 类 型 推理 规则 也 适用 于 静态 方法 和 实例 方法 。 编 译 器 能 够 根据 传人 的 方法 实 
参 推断 类 型 形 参 ; 它 无 法 仅 从 约束 或 返回 值 推断 类 型 形 参 。 因 此 ， 类 型 推理 不 适用 
于 没有 参数 的 方法 。 类 型 推理 在 编译 时 、 编 译 器 尝试 解析 重 载 方法 签名 之 前 进行 。 
编译 器 向 共享 相同 名 称 的 所 有 泛 型 方法 应 用 类 型 推理 逮 辑 。 在 重 载 解析 步骤 中 ， 编 
译 器 仅 包括 类 型 推理 取得 成 功 的 那些 泛 型 方法 。 


在 泛 型 类 中 ， 非 泛 型 方法 可 以 访问 类 级 别 类 型 参数 ， 如 下 所 示 : 
class SampleClass<T> 


void Swap(ref T lhs, ref T rhs) { } 


如 果 定 义 采 用 相同 类 型 参数 作为 包含 类 的 泛 型 方法 ， 编 译 器 将 生成 警告 CS0693， 
因为 在 方法 范围 内 为 内 部 T 提供 的 参数 隐藏 了 为 外 部 T 提 供 的 参数 。 如 果 需 要 使 用 
其 他 类 型 参数 (而 不 是 实例 化 类 时 提供 的 类 型 参数 ) 来 灵活 地 调用 泛 型 类 方法 ， 请 
考虑 为 方法 的 类 型 参数 提供 另 一 个 标识 符 ， 如 下 面 示例 的 GenericList2«T» 中 所 
个 \o 


class GenericList<T> 


// CS0693 
void SampleMethod<T>() { } 
} 


class GenericList2<T> 


//NO warning 
void SampleMethod<U>() { } 


使 用 约束 对 方法 中 的 类 型 参数 启用 更 专门 的 操作 。 此 版 本 的 Swap<T> 现在 名 为 
SwaplfGreater<T>， 它 只 能 与 实现 IComparable<T> 的 类 型 参数 一 起 使 用 。 


void SwapIfGreater<T>(ref T lhs, ref T rhs) where T : System. ICompé 
{ 


T temp; 
if (lhs.CompareTo(rhs) > 0) 
{ 
temp = lhs; 
lhs = rhs; 
rhs = temp; 
} 





泛 型 方法 可 以 使 用 许多 类 型 参数 进行 重 载 。 例 如 ， 下 列 方 法 可 以 全 部 位 于 同一 个 类 
中 : 


void DoWork() { } 
void DoWork<T>() ( } 
void DoWork<T, U»() { } 


有 关 更 多 信息 ， 请 参见 CH 语言 规范 。 
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沁 型 和 效 组 (CH 编程 指 两 ) 


在 C# 2.0 以 及 更 高 版 本 中 ， 下 限 为 需 的 一 维 数组 自动 实现 IList<T>。 这 使 您 可 以 创 
建 能 够 使 用 相同 代码 循环 访问 数组 和 其 他 集合 类 型 的 泛 型 方法 。 此 技术 主要 对 读 取 
集合 中 的 数据 很 有 用 。 IList<T> 接口 不 能 用 于 在 数组 中 添加 或 移 除 元 素 。 如 果 尝 试 
对 此 上 下 文中 的 数组 调用 IList<T> 方法 (例如 RemoveAt) ， 则 将 引发 异常 。 


下 面 的 代码 示例 演示 带 有 IList<T> 输入 参数 的 单个 泛 型 方法 如 何 同时 循环 访问 列表 
和 数组 ， 本 例 中 为 整数 数组 。 


class Program 


( 


static void Main() 


{ 
int[] arr = { ©, 1, 2, 3, 4}; 
List<int> list = new List<int>(); 


for (int x = 5; x < 10; X++) 


list.Add(x); 
} 


ProcessItems<int>(arr); 
ProcessItems<int>(list); 


} 


static void ProcessItems<T>(IList<T> coll) 


// IsReadOnly returns True for the array and False for the 
System.Console.WriteLine 
("IsReadOnly returns (0) for this collection.", 
coll.IsReadOnly); 


// The following statement causes a run-time exception for 
// array, but not for the List. 
//coll.RemoveAt(4); 


foreach (T item in coll) 


{ 
} 


System.Console.WriteLine(); 


System.Console.Write(item.ToString() * " "); 
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泛 型 委托 (CH 编程 指 两) 


委托 可 以 定义 自己 的 类 型 参数 。 引 用 泛 型 委托 的 代码 可 以 指定 类 型 参数 以 创建 已 关 
闭 的 构造 类 型 ， 就 像 实例 化 泛 型 类 或 调用 泛 型 方法 一 样 ， 如 下 例 所 示 : 


public delegate void Del<T>(T item); 
public static void Notify(int i) { } 


Del<int> mi = new Del<int>(Notify); 


C# 2.0 版 具有 称 为 方法 组 转换 的 新 功能 ， 此 功能 适用 于 具体 委托 类 型 和 泛 型 委托 类 
型 ， 并 使 您 可 以 使 用 如 下 简化 的 语法 写 人 上 一 行 : 


Del«int» m2 = Notify; 


在 泛 型 类 内 部 定义 的 委托 使 用 泛 型 类 类 型 参数 的 方式 可 以 与 类 方法 所 使 用 的 方式 相 
同 。 
class Stack<T> 


T[] items; 
int index; 


public delegate void StackDelegate(T[] items); 


引用 委托 的 代码 必须 指定 包含 类 的 类 型 变量 ， 如 下 所 示 : 


private static void DoWork(float[] items) { } 


public static void TestStack() 
{ 


Stack<float> s = new Stack<float>(); 
Stack<float>.StackDelegate d = DoWork; 


根据 典型 设计 模式 定义 事件 时 ， 泛 型 委托 尤其 有 用 ， 因 为 发 送 方 参数 可 以 为 强 类 
型 ， 不 再 需要 强制 转换 成 Object， 或 反 向 强制 转换 。 


delegate void StackEventHandler<T, U>(T sender, U eventArgs); 


class Stack<T> 


{ 
public class StackEventArgs : System.EventArgs { } 
public event StackEventHandler<Stack<T>, StackEventArgs> stackt 
protected virtual void OnStackChanged(StackEventArgs a) 
{ 
stackEvent(this, a); 
} 
} 
class SampleClass 
{ 
public void HandleStackChange<T>(Stack<T> stack, Stack<T>.Stacl 
} 


public static void Test() 
Stack«double» s = new Stack«double»(); 


SampleClass o - new SampleClass(); 
s.stackEvent += o.HandleStackChange; 


E — 
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泛 型 代码 中 的 默认 关键 字 (CH 编程 指南 ) 


在 泛 型 类 和 泛 型 方法 中 产生 的 一 个 问题 是 ， 在 预先 未 知 以 下 情况 时 ， 如 何 将 默认 值 
分 配给 参数 化 类 型 : 


e 本 是 引用 类 型 还 是 值 类 型 。 
e 如 果 T 丁 为 值 类 型 ， 则 它 是 数值 还 是 结构 。 


给 定 参 数 化 类 型 十 的 一 个 变量 t， 只 有 当 T 本 为 引用 类 型 时 ， 语 句 t= null 才 有 效 ; 只 
A4 T 为 数值 类 型 而 不 是 结构 时 ， 语 句 t= 0 才能 正常 使 用 。 解 决 方案 是 使 用 
default 关键 字 ， 此 关键 字 对 于 引用 类 型 会 返回 nul, 对 于 数值 类 型 会 返回 需 。 对 于 
ty, bbe SRE MAbs SX null 的 每 个 结构 成 员 ， 具 体 取决 于 这 些 结构 是 

类 型 还 是 引用 类 型 。 对 于 可 以 为 null 的 值 类 型 ， 默 认 返 回 System.Nullable<T>， 
它 像 任何 结构 一 样 初 始 化 。 


以 下 来 自 GenericList<T> 类 的 示例 显示 了 如 何 使 用 default 关键 字 。 有 关 更 多 信 
息 ， 请 参见 泛 型 概述 。 


namespace ConsoleApplicationi 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
// Test with a non-empty list of integers. 
GenericList<int> gll = new GenericList<int>(); 
gll.AddNode(5); 
gll.AddNode(4); 
gll.AddNode(3); 
int intVal = gll.GetLast(); 
// The following line displays 5. 
System.Console.WriteLine(intVal); 


// Test with an empty list of integers. 
GenericList<int> gll2 = new GenericList«int»(); 
intVal - gll2.GetLast(); 

// The following line displays ©. 
System.Console.WriteLine(intVal); 


// Test with a non-empty list of strings. 
GenericList<string> gll3 = new GenericList<string>(); 
g113.AddNode("five"); 

g113.AddNode("four"); 

string sVal = gll3.GetLlast(); 

// The following line displays five. 
System.Console.WriteLine(sVal); 


// Test with an empty list of strings. 


j 


GenericList<string> gll4 = new GenericList<string>(); 
sVal = gll4.GetLast(); 

// The following line displays a blank line. 
System.Console.WriteLine(sVal); 


// T is the type of data stored in a particular instance of Ger 
public class GenericList<T> 


{ 


private class Node 


{ 


} 


// Each node has a reference to the next node in the 1: 
public Node Next; 

// Each node holds a value of type T. 

public T Data; 


// The list is initially empty. 
private Node head - null; 


// Add a node at the beginning of the list with t as its d: 
public void AddNode(T t) 


u 


} 


Node newNode = new Node(); 
newNode.Next = head; 
newNode.Data = t; 

head = newNode; 


// The following method returns the data value stored in tl 
// the list. If the list is empty, the default value for t: 
// returned. 

public T GetLast() 


( 


// The value of temp is returned as the value of the me 
// The following declaration initializes temp to the at 
// default value for type T. The default value is retui 
// list is empty. 

T temp - default(T); 


Node current - head; 

while (current !- null) 

{ 
temp = current.Data; 
current = current.Next; 


} 


return temp; 
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C++ 模板 和 CH 泛 型 之 间 的 区 别 (CH 编程 指南 ) 


CH 泛 型 和 C++ 模板 都 是 用 于 提供 参数 化 类 型 支持 的 语言 功能 。 然而 ， 这 两 者 之 间 
存在 许多 差异 。 在 语法 层面 上 ，C# 泛 型 是 实现 参数 化 类 型 的 更 简单 方法 ， 不 具有 
C++ 模板 的 复杂 性 。 此 外 ，C# 并 不 尝试 提供 C++ 模板 所 提供 的 所 有 功能 。 在 实 
现 层面 ， 主 要 区 别 在 于 ，C# 泛 型 类 型 替换 是 在 运行 时 执行 的 ， 从 而 为 实例 化 的 对 
: 泛 型 类 型 信息 。 有 关 更 多 信息 ， 请 参见 运行 时 中 的 泛 型 〈《C# 编程 指 

"MJ o 


以 下 是 C# 泛 型 和 C++ 模板 之 间 的 主要 差异 : 


e C# 泛 型 未 提供 与 C++ 模板 相同 程度 的 灵活 性 。 例如 ， 尽 管 在 CH 泛 型 类 中 可 
以 调用 用 户 定义 的 运算 符 ， 但 不 能 调用 算术 运算 符 。 


CH 不 人 允许 非 类 型 模板 参数 ， 如 template C<int i» {}. 

e C# 不 支持 显 式 专用 化 ， 即 特定 类 型 的 模板 的 自 定义 实现 。 
C# 不 支持 部 分 专用 化 : 类 型 参数 子 集 的 自 定义 实现 。 
CH 不 允许 将 类 型 参数 用 作 泛 型 类 型 的 基 类 。 

e CH 不 允许 类 型 参数 具有 默认 类 型 。 


e 在 C# 中 ， 尽 管 构 造 类 型 可 用 作 泛 型 ， 但 泛 型 类 型 参数 自身 不 能 是 泛 型 。 C++ 
确实 允许 模板 参数 。 


C++ 人 允许 那些 可 能 并 非 对 模板 中 的 所 有 类 型 参数 都 有 效 的 代码 ， 然 后 将 检查 该 
代码 中 是 否 有 用 作 类 型 参数 的 特定 类 型 。 C# 要 求 相应 地 编写 类 中 的 代码 ， 使 
之 能 够 使 用 任何 满足 约束 的 类 型 。 例如 ， 可 以 在 C++ 中 编写 对 类 型 参数 的 对 
象 使 用 算术 运算 符 + 和 - 的 函数 ， 这 会 在 使 用 不 支持 这 些 运算 符 的 类 型 来 实例 
化 模板 时 产生 错误 。 C# 不 允许 这 样 ; 唯一 允许 的 语言 构造 是 那些 可 从 约束 推 
导出 来 的 构造 。 
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运行 时 中 的 泛 型 (CH 编程 指南 ) 


将 泛 型 类 型 或 方法 编译 为 Microsoft # H48 (MSIL) 时 ， cad S 具有 类 
型 参数 的 元 数据 。 泛 型 类 型 的 MSIL 的 使 用 因 所 提供 的 类 型 参数 是 值 类 型 还 是 引用 
类 型 而 不 同 。 


第 一 次 用 值 类 型 作为 参数 来 构造 泛 型 类 型 时 ， 运 行 时 会 创建 专用 泛 型 类 型 ， 将 提供 
的 参数 代入 到 MSIL 中 的 适当 位 置 。 对 于 每 个 用 作 参 数 的 唯一 值 类 型 ， 都 会 创建 一 
次 专用 泛 型 类 型 。 


例如 ， 假 设 您 的 程序 代码 声明 了 一 个 由 整数 构造 的 堆栈 : 
Stack<int> stack; 


在 此 位 置 ， 运 行 时 生成 Stack<T> 类 的 专用 版 本 ， 并 相应 地 用 整数 蔡 换 其 参数 。 现 
在 ， 只 要 程序 代码 使 用 整数 堆栈 ， 运 行 时 就 会 重用 生成 的 专用 Stack<T> X. 在 下 
面 的 示例 中 ， 创 建 了 整数 堆栈 的 两 个 实例 ， 它 们 共享 Stack<int> 代码 的 单个 实例 : 


Stack<int> stackOne 
Stack<int> stackTwo 


new Stack<int>(); 
new Stack<int>(); 


但 是 ， 假 定 在 代码 中 的 另 一 个 位 置 创建 了 使 用 不 同 值 类 型 (比如 long 或 用 户 定 义 
的 结构 ) 作为 其 参数 的 另 一 个 Stack<T> X, 因此 ， 运 行 时 将 生成 另 一 个 版 本 的 泛 
型 类 型 ， 并 在 MSIL 中 的 适当 位 置 替 换 long, 由 于 每 个 专用 泛 型 类 本 身 就 包含 值 类 
型 ， 因 此 不 再 需要 转换 。 


对 于 引用 类 型 ， 泛 型 的 工作 方式 略 有 不 同 。 第 一 次 使 用 任何 引用 类 型 构造 泛 型 类 型 

时 ， 运 行 时 会 创建 专用 泛 型 类 型 ， 用 对 象 引 用 蔡 换 MSIL 中 的 参数 。 然后 ， 每 次 使 

用 引用 类 型 作为 参数 来 实例 化 构造 类 型 时 ， 无 论 引 用 类 型 的 具体 类 型 是 什么 ， 运 行 

之 所 以 可 以 这 样 ， 是 因为 所 有 引用 的 
小 相同 


例如 ， 假 设 您 有 两 个 引用 类 型 : 一 个 Customer 类 和 一 个 Order 类 ， 并 且 同 时 假设 
您 创建 了 一 个 Customer 类 型 的 堆栈 : 


class Customer ( ) 
class Order ( } 


Stack«Customer» customers; 


此 时 ， 运 行 时 将 生成 Stack<T> 类 的 一 个 专用 版 本 ， 该 版 本 存储 稍 后 将 填写 的 对 象 
引用 ， 而 不 是 存储 数据 。 假设 下 一 行 代 码 创 建 另 一 个 引用 类 型 的 堆栈 ， 该 堆栈 名 为 
Order : 


Stack<Order> orders = new Stack<Order>(); 


不 同 于 值 类 型 ， 对 于 Order 类 型 不 创建 Stack<T> 类 的 另 一 个 专用 版 本 。 而 是 创建 
Stack<T> 类 的 一 个 专用 版 本 实例 ， 并 将 orders 变量 设置 为 引用 它 。 假设 接 下 来 您 
过 到 一 行 创建 Customer 类 型 堆栈 的 代码 : 


customers = new Stack<Customer>(); 


与 前 面 使 用 Order 类 型 创建 的 Stack<T> 类 一 样 ， 创 建 了 专用 Stack<T> 类 的 另 一 
个 实例 。 包含 在 其 中 的 指针 设置 为 引用 Customer 类 型 大 小 的 内 存 区 域 。 因为 引 
用 类 型 的 数量 会 随 程序 的 不 同 而 大 幅 变 化 ，C# 泛 型 实现 将 编译 器 为 引用 类 型 的 泛 
型 类 创建 的 专用 类 的 数量 减 小 到 一 个 ， 从 而 大 幅 减 小 代码 量 。 


此 外 ， 使 用 值 类 型 或 引用 类 型 参数 实例 化 泛 型 C# 类 时 ， 反 射 可 以 在 运行 时 查询 
它 ， 并 且 可 以 确定 它 的 实际 类 型 及 其 类 型 参数 。 


请 参见 
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.NET Framework 类 库 中 的 泛 型 (CH 编程 指南 ) 


.NET Framework 2.0 版 类 库 提供 一 个 新 的 命名 空间 System.Collections.Generic, 
其 中 包括 几 个 随时 可 用 的 泛 型 集合 类 和 关联 接口 。 其 他 命名 空间 (如 System) 也 
提供 新 的 泛 型 接口 ， 如 IComparable<T>。 与 早期 版 本 的 .NET Framework 所 提供 
的 非 泛 型 集合 类 相 比 ， 这 些 类 和 接口 更 为 高 效 和 类 型 安全 。 在 设计 和 实现 自己 的 自 
定义 集合 类 之 前 ， 请 考虑 是 否 能 够 使 用 .NET Framework 类 库 所 提供 的 类 ， 或 者 是 
否 能 从 .NET Framework 类 库 所 提供 的 类 派生 一 个 类 。 


请 参阅 
C# 编程 指南 
何 时 使 用 泛 型 集合 


集合 和 数据 结构 
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沁 型 和 反射 (CH 编程 指 两 ) 


因为 公共 语言 运行 时 (CLR) 能 够 在 运行 时 访问 泛 型 类 型 信息 ， 所 以 可 以 使 用 反射 获 
取 关 于 泛 型 类 型 的 信息 ， 方 法 与 用 于 非 泛 型 类 型 的 方法 相同 。 有 关 更 多 信息 ， 请 参 
见 运行 时 中 的 泛 型 (CH 编程 指南 ) o 

在 .NET Framework 2.0 中 ， 有 几 个 新 成 员 添 加 到 了 Type 类 中 ， 用 以 启用 泛 型 类 
型 的 运行 时 信息 。 请 参见 有 关 这 些 类 的 文档 来 了 解 有 关 如 何 使 用 这 些 方法 和 属性 的 
更 多 信息 。System.Reflection.Emit 命名 空间 还 包含 支持 泛 型 的 新 成 员 。 请 参见 如 
何 : 用 反射 发 出 定义 泛 型 类 型 。 


有 关 泛 型 反射 中 使 用 的 术语 的 固定 条 件 列表 ， 请 参见 IsGenericType 属性 各 注 。 


System.Type 成 员 名 称 


IsGenericType 
GetGenericArguments 


GetGenericTypeDefinition 


GetGenericParameterConstraints 


ContainsGenericParameters 


GenericParameterAttributes 


GenericParameterPosition 


IsGenericParameter 


IsGenericTypeDefinition 


DeclaringMethod 


MakeGenericType 


此 外 ，Methodlnfo 类 中 还 添加 了 新 成 员 以 启用 泛 型 方法 的 运行 时 信息 。 有 关 泛 型 方 


说 明 
如 果 类 型 为 泛 型 ， 则 返回 true, 


返回 Type 对 象 数组 ， 这 些 对 象 表示 为 构 
造 类 型 提供 的 类 型 变量 ， 或 泛 型 类 型 定义 
的 类 型 参数 。 


返回 当前 构造 类 型 的 基础 泛 型 类 型 定义 。 


返回 表示 当前 泛 型 类 型 参数 约束 的 Type 
对 象 的 数组 。 


如 果 类 型 或 其 任意 封闭 类 型 或 方法 包含 没 
有 被 提供 特定 类 型 的 类 型 参数 ， 则 返回 
true。 


获取 GenericParameterAttributes 标志 
的 组 合 ， 这 些 标志 描述 当前 泛 型 类 型 参数 
的 特殊 约束 。 


对 于 表示 类 型 参数 的 Type tk, AH 
型 参数 在 声明 该 类 型 参数 的 泛 型 类 型 定义 
或 泛 型 方法 定义 的 类 型 参数 列表 中 的 位 
iB. 


获取 一 个 值 ， 该 值 指示 当前 Type 是 表示 
泛 型 类 型 定义 的 类 型 参数 ， 还 是 泛 型 方法 
定义 的 类 型 参数 。 


获取 一 个 值 ， 该 值 指 示 当 前 Type 是 否 

示 可 以 用 来 构造 其 他 泛 型 类 型 的 泛 型 类 型 
定义 。 如 果 类 型 表示 泛 型 类 型 的 定义 ， 则 
返回 true。 


返回 定义 当前 泛 型 类 型 参数 的 泛 型 方法 ; 
如 果 类 型 参数 不 是 由 泛 型 方法 定义 的 ， 则 
返回 空 值 。 
用 类 型 数组 的 元 素 蔡 代 当 前 泛 型 类 型 定义 
的 类 型 参数 ， 并 返回 表示 结果 构造 类 型 的 
Type 对 象 。 


法 反射 中 使 用 的 术语 的 固定 条 件 列 表 ， 请 参见 IsGenericMethod 属性 各 注 。 
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System.Reflection.Memberlnfo 5s, BR 
成 员 名 称 
IsGenericMethod 如 果 方 法 为 泛 型 ， 则 返回 true. 
返回 Type 对 象 数组 ， 这 些 对 象 表示 构造 泛 
GetGenericArguments 型 方法 的 类 型 变量 ， 或 泛 型 方法 定义 的 类 
型 参数 。 
GetGenericMethodDefinition 返回 当前 构造 方法 的 基础 泛 型 方法 定义 。 
如 果 方 法 或 其 任意 封闭 类 型 包含 没有 被 提 
ContainsGenericParameters 供 特 定 类 型 的 任何 类 型 参数 ， 则 返回 
true。 


如 果 当 前 Methodlnfo 表示 泛 型 方法 的 定 
L, MAE true, 


用 类 型 数组 的 元 素 蔡 代 当前 泛 型 方法 定义 
MakeGenericMethod 的 类 型 参数 ， 并 返回 表示 结果 构造 方法 的 
Methodlnfo 对 象 。 


IsGenericMethodDefinition 
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泛 型 和 特性 (CH 编程 指南 ) 
特性 可 以 应 用 于 泛 型 类 型 中 ， 方 式 与 应 用 于 非 泛 型 类 型 相同 。 有 关上 应 用 特性 的 更 多 
信息 ， 请 参见 特性 (C# 和 Visual Basic) 。 


自 定义 特性 只 人 允许 引用 开放 泛 型 类 型 (未 提供 类 型 参数 的 泛 型 类 型 ) 和 封闭 构造 泛 
型 类 型 (为 所 有 类 型 参数 提供 参数 ) 。 


下 面 的 示例 使 用 此 自 定 义 特性 : 


class CustomAttribute : System.Attribute 


public System.Object info; 


特性 可 以 引用 开放 式 泛 型 类 型 : 


public class GenericClassi<T> { } 


[CustomAttribute(info = typeof(GenericClassi<>) ) ] 
class ClassA { } 


使 用 数目 适当 的 若干 个 逗号 指定 多 个 类 型 参数 。 在 此 示例 中 ，GenericClass2 有 两 
个 类 型 参数 : 


public class GenericClass2<T, U> ( } 
[CustomAttribute(info = typeof (GenericClass2<,>))] 
class ClassB { } 


特性 可 以 引用 封闭 式 构造 泛 型 类 型 : 


public class GenericClass3<T, U, V> ( } 


[CustomAttribute(info = typeof(GenericClass3<int, double, string»): 
class ClassC { } 





引用 泛 型 类 型 参数 的 特性 将 导致 编译 时 错误 : 


//[CustomAttribute(info = typeof(GenericClass3<int, T, string>)) ] 
class ClassD<T> { } 


| g 
不 能 从 Attribute 继承 泛 型 类 型 : 











//public class CustomAtt«T» : System.Attribute {} //Error 


若 要 在 运行 时 获得 有 关 泛 型 类 型 或 类 型 参数 的 信息 ， 可 以 使 用 System.Reflection 
的 方法 。 有 关 更 多 信息 ， 请 参见 泛 型 和 反射 (CH 编程 指南 ) 

请 参阅 

C# 编程 指南 

泛 型 (CH 编程 指南 ) 

利用 特性 扩展 元 数据 


索引 器 (CH 编程 指南 ) 


索引 器 允许 类 或 结构 的 实例 就 像 数组 一 样 进行 索引 。 索 引 器 类 似 于 属性 ， 不 同 之 处 
在 于 它们 的 取 值 图 数 采 用 参数 。 


在 下 面 的 示例 中 ， 定 义 了 一 个 泛 型 类 ， 并 为 其 提供 了 简单 的 get 和 set RARA 
P Ee 。 Program 类 创建 了 此 类 的 一 个 实例 ， 用 于 存储 字 
FE, 


class SampleCollection<T> 

{ 
// Declare an array to store the data elements. 
private T[] arr = new T[100]; 


// Define the indexer, which will allow client code 
// to use [] notation on the class instance itself. 
// (See line 2 of code in Main below.) 
public T this[int i] 
{ 
get 
{ 
// This indexer is very simple, and just returns or sel 
// the corresponding element from the internal array. 
return arr[i]; 


arr[i] = value; 


// This class shows how client code uses the indexer. 
class Program 


{ 
static void Main(string[] args) 
{ 
// Declare an instance of the SampleCollection type. 
SampleCollection<string> stringCollection = new SampleColle 
// Use [] notation on the type. 
stringCollection[0] = "Hello, World"; 
System.Console.WriteLine(stringCollection[0]); 
j 
j 
// Output: 


// Hello, World. 


«| = 








y = 
Ef TER 


有 关 更 多 示例 ， 请 参阅 相关 章节 。 


表达 式 主 体 定 义 
BU HIS e PE TIU 
RAIZ : 


public Customer this[long id] -» store.LookupCustomer(id); 
索引 器 必须 为 只 读 ， 并 且 你 不 能 使 用 get 取 值 画 数 关键 字 。 


索引 器 概述 


e 使 用 索引 器 可 以 用 类 似 于 数组 的 方式 为 对 象 建立 索引 。 

e get 取 值 函数 返回 值 。 set RERA. 

e this 关键 字 用 于 定义 索引 器 。 

value 关键 字 用 于 定义 由 set 索引 器 分 配 的 值 。 

索引 器 不 必 根 据 整数 值 进行 索引 ; 由 你 决定 如 何 定义 特定 的 查找 机 制 。 
索引 器 可 被 重 载 。 

索引 器 可 以 有 多 个 形 参 ， 例 如 当 访问 二 维 数组 时 。 


相关 章节 


使 用 索引 器 (CH 编程 指南 ) 

e 接口 中 的 索引 器 (CH 编程 指南 ) 

。 属性 和 索引 器 之 间 的 比较 (CH 编程 指南 ) 
限制 访问 器 可 访问 性 (CH 编程 指南 ) 


CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 


MSDN C# 编程 指南 & 参考 手册 2015 


CH 编程 指南 
属性 (CH 编程 指南 ) 


索引 器 (CH 编程 指南 ) 281 


使 用 索引 器 (CH 编程 指 两 ) 


索引 器 在 语法 上 方便 您 创建 客户 端点 用 程序 可 将 其 作为 数组 访问 的 类 、 结 构 或 接 
口 。 索 引 器 经 常 是 在 主要 用 于 封装 内 部 集合 或 数组 的 类 型 中 实现 的 。 例 如 ， 假 定 具 
有 一 个 名 为 TempRecord 的 类 ， 此 类 表示 在 24 小 时 内 的 10 个 不 同时 间 记 录 的 华 
氏 度 。 此 类 包含 一 个 表示 温度 的 float 类 型 的 名 为 “Yemps” 的 数组 和 表示 记录 温度 的 
日 期 的 DateTime。 通 过 在 此 类 中 实现 一 个 索引 器 ， 客 户 端 可 以 通过 float temp = 
tr[4] 而 不 是 float temp = trtemps[4] 语法 访问 TempRecord 实例 中 的 温度 。 索 引 器 
2:25 Oe DEM SOUS ree 
类 及 其 用 途 。 


要 声明 类 或 结构 上 的 索引 器 ， 请 使 用 this 关键 字 ， 如 下 例 所 示 : 


public int this[int index] // Indexer declaration 


// get and set accessors 


各 注 

索引 器 类 型 及 其 参数 类 型 必须 至 少 如 同 索引 器 本 身 一 样 是 可 访问 的 。 有 关 可 访问 级 
别 的 更 多 信息 ， 请 参见 访问 修饰 符 。 

有 关 如 何 对 接口 使 用 索引 器 的 更 多 信息 ， 请 参见 接口 索引 器 。 


索引 器 的 签名 由 其 形 参 的 数量 和 类 型 组 成 。 它 不 包括 索引 器 类 型 或 形 参 名 。 如 果 在 
同一 类 中 声明 一 个 以 上 的 索引 器 ， 则 它们 必须 具有 不 同 的 签名 。 


索引 器 值 不 属于 变量 ; 因此 ， 不 能 将 索引 器 值 作为 ref 或 out 参数 进行 传递 。 
要 为 索引 器 提供 一 个 其 他 语言 可 以 使 用 的 名 字 ， 请 使 用 声明 中 的 name 特性 。 例 
如 : 


[System.Runtime.CompilerServices.IndexerName("TheItem")] 
public int this [int index] // Indexer declaration 


} 
此 索引 器 将 具有 名 称 Theltem。 不 提供 名 称 特性 将 生成 Item 默认 名 称 。 
示例 1 


说 明 


下 面 的 示例 说 明 如 何 声明 私有 数组 字段 、temps 和 索引 器 。 使 用 索引 器 可 直接 访问 
实例 tempRecord[i]。 另 一 种 使 用 索引 器 的 方法 是 将 数组 声明 为 public 成 员 并 直接 
访问 它 的 成 员 tempRecord.temps[i]。 


请 注意 ， 当 计算 索引 器 的 访问 时 (例如 ， 在 Console.Write 语句 中 ) ， 将 调用 get 
访问 器 。 因 此 ， 如 果 get 访问 器 不 存在 ， 将 发 生 编译 时 错误 。 
代码 


class TempRecord 


{ 
// Array of temperature values 
private float[] temps = new float[10] { 56.2F, 56.7F, 56.5F, 5¢ 
61.3F, 65.9F, 62.1F, 5% 

// To enable client code to validate input 
// when accessing your indexer. 
public int Length 
{ 

get { return temps.Length; } 
// Indexer declaration. 
// If index is out of range, the temps array will throw the ext 
public float this[int index] 
{ 

get 

{ 

return temps[index]; 

} 

set 

{ 

temps[index] = value; 
} 
} 


class MainClass 
1 
static void Main() 
{ 
TempRecord tempRecord = new TempRecord(); 
// Use the indexer's set accessor 
tempRecord[3] = 58.3F; 
tempRecord[5] = 60.1F; 


// Use the indexer's get accessor 
for (int i = 05 i < 10; i++) 


{ 
} 


System.Console.WriteLine("Element #{0} = {1}", i, tempf 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


} 
} 
/* Output: 
Element #0 = 56.2 
Element #1 = 56.7 
Element #2 = 56.5 
Element #3 = 58.3 
Element #4 = 58.8 
Element #5 = 60.1 
Element #6 = 65.9 
Element #7 = 62.1 
Element #8 = 59.2 
Element #9 = 57.5 
nur 


fi EE. LLL x] 


使 用 其 他 值 进 行 乘 引 


CH 并 不 将 索引 类 型 限制 为 整数 。 例 如 ， 对 索引 器 使 用 字符 串 可 能 是 有 用 的 。 通 过 
搜索 集合 内 的 字符 串 并 返回 相应 的 值 ， 可 以 实现 此 类 索引 器 。 由 于 访问 器 可 被 重 
载 ， 字 符 串 和 整数 版 本 可 以 共存 。 





示例 2 

说 明 

在 此 例 中 ， 声 明了 存储 星期 几 的 类 。 声 明了 一 个 get 访问 器 ， 它 接受 字符 串 (天 名 
称 ) ， 并 返回 相应 的 整数 。 例 如 ， 星 期 日 将 返回 0， 星 期 一 将 返回 1， 等 等 。 


代码 


// Using a string as an indexer value 
class DayCollection 


{ 
string[] days = { "Sun", "Mon", "Tues", "Wed", "Thurs", "Fri", 
// This method finds the day or returns -1 
private int GetDay(string testDay) 
{ 
for (int j = 0; j < days.Length; j++) 
if (days[j] == testDay) 
{ 
return j; 
} 
} 
throw new System.ArgumentOutOfRangeException(testDay, "tesi 
j 
// The get accessor returns an integer for a given string 
public int this[string day] 
{ 
get 
{ 
return (GetDay(day)); 
} 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
DayCollection week = new DayCollection(); 
System.Console.WriteLine(week["Fri"]); 
// Raises ArgumentOutOfRangeException 
System.Console.WriteLine(week["Made-up Day"]); 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
// Output: 5 


JE E) 


可 靠 编程 





提高 索引 器 的 安全 性 和 可 靠 性 有 两 种 主要 的 方法 : 


e 确保 结合 某 一 类 型 的 错误 处 理 策略 ， 以 处 理 万 一 客户 端 代 码 传人 无 效 素 引 值 的 
情况 。 在 本 主题 前 面 的 第 一 个 示例 中 ，TempRecord 类 提供 了 Length 属性 ， 
使 客户 端 代码 能 够 在 将 输入 传递 给 索引 器 之 前 对 其 进行 验证 。 也 可 以 将 错误 处 
理 代 码 放 入 索引 器 自身 内 部 。 确 保 为 用 户 记 录 在 索引 器 的 访问 器 中 引发 的 任何 


Ha 
F IB. 


应 当 为 get 和 set 访问 器 的 可 访问 性 设置 尽 可 能 多 的 限制 。 这 一 点 对 set 访问 
器 尤为 重要 。 有 关 更 多 信息 ， 请 参见 限制 访问 器 可 访问 性 (CH 编程 指南 ) o 


请 参阅 

C# 编程 指南 

索引 器 (CH 编程 指南 ) 
属性 (CH 编程 指南 ) 


接口 中 的 索引 器 (CH 编程 指 两 ) 

索引 器 可 在 接口 (CHSS) 上 声明 。 接 口 索 引 器 的 访问 器 与 关 索 引 器 的 访问 器 具 
有 以 下 方面 的 不 同 : 

。 接 口 访问 器 不 使 用 修饰 符 。 

。 接 口 访问 器 没有 体 。 

因此 ， 访 问 器 的 用 途 是 指示 这 引 器 是 读 写 、 只 读 还 是 只 写 。 

以 下 是 接口 索引 器 访问 器 的 示例 : 


public interface ISomeInterface 


{ 
/A 
// Indexer declaration: 
string this[int index] 
get; 
set; 
j 
} 


一 个 索引 器 的 签名 必须 区 别 于 在 同一 接口 中 声明 的 其 他 所 有 索引 器 的 签名 。 
下 面 的 示例 显示 如 何 实现 接口 索引 器 。 


// Indexer on an interface: 
public interface ISomeInterface 


// Indexer declaration: 
int this[int index] 
{ 

get; 

Set. 


j 


// Implementing the interface. 
class IndexerClass : ISomeInterface 
: private int[] arr = new int[100]; 
public int this[int index] // indexer declaration 
{ 
get 
{ 


// The arr object will throw IndexOutOfRange exception 
return arr[index]; 


} 
set 
arr[index] = value; 
} 
} 
} 
class MainClass 
{ 
static void Main() 
{ 
IndexerClass test = new IndexerClass(); 
System.Random rand = new System.Random(); 
// Call the indexer to initialize its elements. 
for (int i = 05 i < 105 i++) 
{ 
test[i] = rand.Next(); 
} 
for (int i = 0; i < 10; i++) 
{ 
System.Console.WriteLine("Element #{0} = {1}", i, test| 
} 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
/* Sample output: 
Element #0 = 360877544 
Element #1 = 327058047 
Element #2 = 1913480832 
Element #3 = 1519039937 
Element #4 = 601472233 
Element #5 = 323352310 
Element #6 = 1422639981 
Element #7 = 1797892494 
Element #8 = 875761049 
Element #9 = 393083859 
rA 





在 上 例 中 ， 可 以 通过 使 用 接口 成 员 的 完全 限定 名 来 使 用 显 式 接口 成 员 实 现 。 例 如 : 


public string ISomeInterface.this 


t 
} 


但 是 ， 只 有 当 类 使 用 同一 索引 器 签名 实现 一 个 以 上 的 接口 时 ， 为 避免 多 义 性 才 需 要 
使 用 完全 限定 名 。 人 例如， 如果 Employee 类 实现 的 是 两 个 接口 ICitizen 和 
IEmployee， 并 且 这 两 个 接口 具有 相同 的 索引 器 签名 ， 则 必须 使 用 显 式 接口 成 员 实 
现 。 即 ， 以 下 索引 器 声明 : 


public string IEmployee.this 


j 


ft IEmployee 接口 上 实现 索引 器 ， 而 以 下 声明 : 


public string ICitizen.this 
{ 
j 


在 ICitizen 接口 上 实现 索引 器 。 


请 参阅 

C# 编程 指南 

索引 器 (CH 编程 指南 ) 
属性 (CH 编程 指南 ) 
接口 (C# 编程 指南 ) 


属性 和 索引 器 之 间 的 比较 (CH 编程 指责) 


索引 器 与 属性 类 似 。 除 下 表 中 显示 的 差别 外 ， 为 属性 访问 器 定义 的 所 有 规则 同样 适 


用 于 索引 器 访问 器 。 
属性 


允许 像 调 用 公共 数据 成 员 一 样 调 
用 方法 。 


可 通过 简单 的 名 称 进行 访问 。 
可 以 为 静态 成 员 或 实例 成 员 。 
属性 的 get 访问 器 没有 参数 。 
属性 的 set 访问 器 包含 隐 式 
value 参数 。 


支持 对 自动 实现 的 属性 (CH 编 
程 指南 ) 使 用 短语 法 。 

请 参阅 

C# 编程 指南 

索引 器 (CH 编程 指南 ) 
属性 (CH 编程 指南 ) 


索引 器 


人 允许 对 一 个 对 象 本 身 使 用 数组 表示 法 来 访问 
该 对 象 内 部 集合 中 的 元 素 。 


可 通过 索引 器 进行 访问 。 
必须 为 实例 成 员 。 


索引 器 的 get 访问 器 具有 与 索引 器 相同 的 形 
SR 


£z o 


除了 值 参数 外 ， 索 引 器 的 set 访问 器 还 具有 
与 素 引 器 相同 的 形 参 表 。 


不 支持 短语 法 。 


接口 (CH 编程 指南 ) 


接口 包含 类 或 结构 可 以 实现 的 一 组 相关 功能 的 定义 。 


例如 ， 使 用 接口 可 以 在 类 中 包括 来 自 多 个 源 的 行为 。 由 于 C# 语 言 不 支持 多 重 继 
承 ， 所 以 该 功能 很 重要 。 此 外 ， 如 果 要 模拟 结构 的 继承 ， 也 必须 使 用 接口 ， 因 为 它 
们 无 法 实际 从 另 一 个 结构 或 类 继承 。 


可 使 用 interface 关键 字 定义 接口 ， 如 以 下 示例 所 示 。 


interface IEquatable<T> 


bool Equals(T obj); 


实现 IEquatable« T» 接口 的 任何 类 或 结构 都 必须 包含 与 该 接口 指定 的 签名 匹配 的 
Equals 方法 的 定义 。 因 此 ， 可 以 依靠 实现 IEquatable<T> 的 类 来 包含 Equals A 
法 ， 类 的 实例 可 以 通过 该 方法 确定 它 是 否 等 于 相同 类 的 另 一 个 实例 。 


IEquatable<T> 的 定义 不 为 Equals 提供 实现 。 该 接口 仅 定义 签名 。 这 样 ，C# 中 的 
接口 便 类 似 于 其 中 所 有 方法 都 是 抽象 方法 的 抽象 类 。 但 是 ， 类 或 结构 可 以 实现 多 个 
接口 ， 但 是 类 只 能 继承 单个 类 (抽象 或 不 抽象 ;。 因 此 ， 使 用 接口 可 以 在 类 中 包括 
来 自 多 个 源 的 行为 。 


有 关 抽 象 类 的 详细 信息 ， 请 参阅 抽象 类 、 密 封 类 及 类 成 员 。 


接口 可 以 包含 方法 、 属 性 、 事 件 、 索 引 器 或 这 四 种 成 员 类 型 的 任意 组 合 。 有 关 示 例 
的 链接 ， 请 参阅 相关 章节 。 接 口 不 能 包含 常量 、 字 段 、 运 算 符 、 实 例 构造 男 数 、 析 
构 范 数 或 类 型 。 接 口 成 员 会 自动 成 为 公共 成 员 ， 不 能 包含 任何 访问 修饰 符 。 成 员 也 
不 能 是 静态 成 员 。 
若 要 实现 接口 成 员 ， 实 现 类 的 对 应 成 员 必须 是 公共 、 非 静态 ， 并 且 具 有 和 与 接口 成 员 
相同 的 名 称 和 签名 。 


当 类 或 结构 实现 接口 时 ， 类 或 结构 必须 为 该 接口 定义 的 所 有 成 员 提 供 实现 。 接 口 本 
身 不 提供 类 或 结构 可 以 通过 继承 基 类 功能 的 方式 来 继承 的 任何 功能 。 但 是 ， 如 果 基 
类 实现 接口 ， 则 从 基 类 派生 的 任何 类 都 会 继承 该 实现 。 


下 面 的 示例 演示 IEquatable<T> 接口 的 实现 。 实 现 类 Car 必须 提供 Equals 方法 的 
实现 。 


public class Car : IEquatable<Car> 

{ 
public string Make {get; set;} 
public string Model { get; set; } 
public string Year { get; set; } 


// Implementation of IEquatable<T> interface 
public bool Equals(Car car) 


if (this.Make == car.Make && 
this.Model == car.Model && 
this.Year == car.Year) 


{ 
} 


else 
return false; 


return true; 


| mco o te A = 
个 接口 可 能 会 声明 一 个 具有 get 访问 器 的 属性 。 实 现 该 接口 的 类 可 以 声明 同时 具有 
get 和 set 访问 器 的 相同 属性 。 但 是 ， 如 果 属 性 或 索引 器 使 用 显 式 实现 ， 则 访问 器 
必须 匹配 。 有 关 显 式 实现 的 详细 信息 ， 请 参阅 显 式 接口 实现 (CH 编程 指南 ) 和 接 
口 属性 (CH 编程 指南 ) 。 


接口 可 以 实现 其 他 接口 。 类 可 能 通过 它 继承 的 基 类 或 通过 其 他 接口 实现 的 接口 来 多 
次 包含 某 个 接口 。 但 是 ， 类 只 能 提供 接口 的 实现 一 次 ， 并 且 仅 当 类 将 接口 作为 类 定 
义 的 一 部 分 (class ClassName : InterfaceName) 进行 声明 时 才能 提供 。 如 果 由 于 继 
承 实现 接口 的 基 类 而 继承 了 接口 ， 则 基 类 会 提供 接口 的 成 员 的 实现 。 但 是 ， 派 生 类 
可 以 重新 实现 接口 成 员 ， 而 不 是 使 用 继承 的 实现 。 


类 还 可 以 使 用 虚拟 成 员 实现 接口 成 员 。 在 这 种 情况 下 ， 派 生 类 可 以 通过 重 写 虚拟 
成 员 来 更 改 接口 行为 。 有 关 虚 拟 成 员 的 详细 信息 ， 请 参阅 多 态 性 。 


接口 摘要 


接口 具有 以 下 属性 : 

。 接口 类 似 于 抽象 基 类 。 实 现 接口 的 任何 类 或 结构 都 必须 实现 其 所 有 成 员 。 
e 接口 无 法 直接 进行 实例 化 。 其 成 员 由 实现 接口 的 任何 类 或 结构 来 实现 。 
e 接口 可 以 包含 事件 、 索 引 器 、 方 法 和 属性 。 

。 接口 不 包含 方法 的 实现 。 


e 一 个 类 或 结构 可 以 实现 多 个 接口 。 一 个 类 可 以 继承 一 ， 还 可 实 
多 个 接口 。 


一 个 或 


F 


将 
e 
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本 节 内 容 


显 式 接 口 实现 (CH 编程 指南 ) 

说 明 如 何 创建 特定 于 接口 的 类 成 员 。 

如 何 : 显 式 实现 接口 成 员 (CH 编程 指南 ) 

提供 有 关 如 何 显 式 实现 接口 的 成 员 的 示例 。 

如 何 : 显 式 实现 两 个 接口 的 成 员 (C# 编程 指南 ) 
提供 有 关 如 何 使 用 继承 显 式 实现 接口 的 成 员 的 示例 。 


相关 章节 


e 接口 属性 〈C# 编程 指南 ) 

e 接口 中 的 索引 器 (CH 编程 指南 ) 

e 如 何 : 实现 接口 事件 (CH 编程 指南 ) 
e 类 和 结构 (CH 编程 指南 ) 

继承 (CH 编程 指南 ) 

方法 (CH 编程 指南 ) 

e ZANE (CH 编程 指南 ) 

e 抽象 类 、 密 封 类 及 类 成 员 (C# 编程 指南 ) 
。 属性 (CH 编程 指南 ) 

e 事件 (CH 编程 指南 ) 

e 索引 器 (CH 编程 指南 ) 


重要 章节 


Learning C# 3.0: Master the Fundamentals of C# 3.0 (学 习 C# 3.0 : 掌握 C# 3.0 


的 基本 知识 ) 中 的 Interfaces (接口 ) 


请 参阅 
C 编程 指南 
继承 (CH 编程 指南 ) 


接口 (CH 编程 指南 ) 


显 式 接口 实现 (CH 编程 指南 ) 

如 果 类 实现 两 个 接口 ， 并 且 这 两 个 接口 包含 具有 相同 签名 的 成 员 ， 那 么 在 类 中 实现 
该 成 员 将 导致 两 个 接口 都 使 用 该 成 员 作 为 它们 的 实现 。 在 下 面 的 示例 中 ， 所 有 对 
Paint 调用 方法 相同 。 


class Test 


{ 
static void Main() 
{ 
SampleClass sc = new SampleClass(); 
IControl ctrl = (IControl)sc; 
ISurface srfc = (ISurface)sc; 
// The following lines all call the same method. 
sc.Paint(); 
ctrl.Paint(); 
srfc.Paint(); 
} 
} 
interface IControl 
{ 
void Paint(); 
} 


interface ISurface 
void Paint(); 
class SampleClass : IControl, ISurface 


// Both ISurface.Paint and IControl.Paint call this method. 
public void Paint() 


{ 
Console.WriteLine("Paint method in SampleClass"); 
j 
j 
// Output: 


// Paint method in SampleClass 
// Paint method in SampleClass 
// Paint method in SampleClass 


然而 ， 如 果 两 个 接口 成 员 执 行 不 同 的 函数 ， 那 么 这 可 能 会 导致 其 中 一 个 接口 的 实现 
不 正确 或 两 个 接口 的 实现 都 不 正确 。 可 以 显 式 地 实现 接口 成 员 -- 即 创建 一 个 仅 通过 
该 接口 调用 并 且 特 定 于 该 接口 的 类 成 员 。 这 是 使 用 接口 名 称 和 一 个 句点 命名 该 类 成 
员 来 实现 的 。 例 如 : 


public class SampleClass : IControl, ISurface 


{ 
void IControl.Paint() 
{ 
System.Console.WriteLine("IControl.Paint"); 
void ISurface.Paint() 
{ 
System.Console.WriteLine("ISurface.Paint"); 
j 
} 


类 成 员 IControl.Paint 只 能 通过 IControl 接口 使 用 ，ISurface.Paint 只 能 通过 
ISurface 使 用 。 两 个 方法 实现 都 是 分 离 的 ， 都 不 可 以 直接 在 类 中 使 用 。 例 如 : 


// Call the Paint methods from Main. 


SampleClass obj - new SampleClass(); 
//obj.Paint(); // Compiler error. 


IControl c - (IControl)obj; 
c.Paint(); // Calls IControl.Paint on SampleClass. 


ISurface s - (ISurface)obj; 
s.Paint(); // Calls ISurface.Paint on SampleClass. 


// Output: 


// IControl.Paint 
// ISurface.Paint 


Ea us 于 解决 两 个 接口 分 别 声 明 具 有 相同 名 称 的 不 同 成 员 (如 属性 和 方法 ) 
5152 


interface ILeft 
int P ( get;) 
interface IRight 


int P(); 


ATE HR 类 必须 对 属性 P 和 /或 方法 P 使 用 显 式 实现 以 避免 编译 器 
错误 。 例 如 : 
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class Middle : ILeft, IRight 


{ 
public int P() { return 0; } 
int ILeft.P { get { return 0; }} 
} 
请 参阅 


C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 
接口 (CH 编程 指南 ) 
继承 (CH 编程 指南 ) 


显 式 接 口 实现 (CH 编程 指南 ) 296 


如 何 : 显 式 实现 接口 成 员 (CH 编程 指南 ) 


本 示例 声明 一 个 接口 IDimensions 和 一 个 类 Box， 该 类 显 式 实现 接口 成 员 
getLength 和 getWidth。 通 过 接口 实例 dimensions 访问 这 些 成 员 。 


interface IDimensions 


j 


float getLength(); 
float getWidth(); 


class Box : IDimensions 


( 


float lengthInches; 
float widthInches; 


Box(float length, float width) 
{ 
lengthInches = length; 
widthInches = width; 
} 
// Explicit interface member implementation: 
float IDimensions.getLength() 


{ 
} 


// Explicit interface member implementation: 
float IDimensions.getWidth() 


return lengthInches; 


{ 
return widthInches; 
J 
static void Main() 
t 


// Declare a class instance box1: 
Box box1 = new Box(30.0f, 20.0f); 


// Declare an interface instance dimensions: 
IDimensions dimensions = (IDimensions)box1; 


// The following commented lines would produce compilation 
// errors because they try to access an explicitly implemer 
// interface member from a class instance: 

//System.Console.WriteLine("Length: {0}", boxi.getLength(): 
//System.Console.WriteLine("Width: {0}", boxi.getWidth()); 


// Print out the dimensions of the box by calling the meth: 
// from an instance of the interface: 
System.Console.WriteLine("Length: {0}", dimensions.getLeng! 


System.Console.WriteLine("Width: {0}", dimensions.getWidthi 








} 
} 
/* Output: 
Length: 30 
Width: 20 
2 
图 =n 
可 靠 编程 


。 请 注意 Main 方法 中 下 列 代码 行 被 注释 掉 ， 因 为 它们 将 产生 编译 错误 。 显 式 实 
现 的 接口 成 员 不 能 从 类 实例 访问 : 


//System.Console.WriteLine("Length: {0}", box1i.getLength()); 
//System.Console.WriteLine("Width: {0}", boxi.getWidth()); 


。 还 请 注意 ，Main 方法 中 的 下 列 代码 行 成 功 输出 框 的 尺寸 ， 因 为 这 些 方法 是 从 
接口 实例 调用 的 : 


System.Console.WriteLine("Length: {0}", dimensions.getLength()) 
System.Console.WriteLine("Width: {0}", dimensions.getWidth()); 





请 参阅 

C# 编程 指南 

类 和 结构 (CH 编程 指南 ) 

接口 (CH 编程 指南 ) 

如 何 : 显 式 实现 两 个 接口 的 成 员 (CR 编程 指南 ) 


如 何 : 显 陈 实现 两 个 接口 的 成 员 (CH 编程 指责) 


显 式 接口 实现 还 允许 程序 员 实现 具有 相同 成 员 名 称 的 两 个 接口 ， 并 为 每 个 接口 成 员 
各 提供 一 个 实现 。 本 示例 同时 以 公制 单位 和 英制 单位 显示 框 的 尺寸 。Box 类 实现 
IEnglishDimensions 和 IMetricDimensions 两 个 接口 ， 它 们 表示 不 同 的 度量 系统 。 
两 个 接口 有 相同 的 成 员 名 称 Length 和 Width. 


// Declare the English units interface: 
interface IEnglishDimensions 
{ 

float Length(); 

float Width(); 


} 


// Declare the metric units interface: 
interface IMetricDimensions 
{ 

float Length(); 

float Width(); 


} 


// Declare the Box class that implements the two interfaces: 
// IEnglishDimensions and IMetricDimensions: 
class Box : IEnglishDimensions, IMetricDimensions 
{ 
float lengthinches; 
float widthInches; 


public Box(float length, float width) 


{ 
lengthInches = length; 


widthInches = width; 
} 


// Explicitly implement the members of IEnglishDimensions: 
float IEnglishDimensions.Length() 


{ 
return lengthInches; 
} 
float IEnglishDimensions.Width() 
{ 
return widthInches; 
} 


// Explicitly implement the members of IMetricDimensions: 
float IMetricDimensions.Length() 


{ 
return lengthInches * 2.54f; 


j 


float IMetricDimensions.Width() 


{ 
return widthInches * 2.54f; 
} 
static void Main() 
{ 
// Declare a class instance box1: 
Box boxi = new Box(30.0f, 20.0f); 
// Declare an instance of the English units interface: 
IEnglishDimensions eDimensions = (IEnglishDimensions)box1; 
// Declare an instance of the metric units interface: 
IMetricDimensions mDimensions = (IMetricDimensions)box1; 
// Print dimensions in English units: 
System.Console.WriteLine("Length(in): {0}", eDimensions.Ler 
System.Console.WriteLine("Width (in): {0}", eDimensions.Wit 
// Print dimensions in metric units: 
System.Console.WriteLine("Length(cm): {0}", mDimensions.Ler 
System.Console.WriteLine("Width (cm): {0}", mDimensions.Wit 
} 
} 
/* Output: 
Length(in): 30 
Width (in): 20 
Length(cm): 76.2 
Width (cm): 50.8 
no 





可 靠 编程 





如 果 希 望 默 认 度量 采用 英制 单位 ， 请 正常 实现 Length 和 Width 这 两 个 方法 ， 并 从 
IMetricDimensions 接口 显 式 实现 Length 和 Width 方法 : 


// Normal implementation: 
public float Length() 


( 


return lengthInches; 


} 
public float Width() 
{ 


} 


// Explicit implementation: 
float IMetricDimensions.Length() 


return widthInches; 


{ 

return lengthInches * 2.54f; 
} 
float IMetricDimensions.Width() 
{ 

return widthInches * 2.54f; 
} 


这 种 情况 下 ， 可 以 从 类 实例 访问 英制 单位 ， 而 从 接口 实例 访问 公制 单位 : 


public static void Test() 


t 
Box box1 = new Box(30.0f, 20.0f); 
IMetricDimensions mDimensions = (IMetricDimensions)box1; 
System.Console.WriteLine("Length(in): {0}", boxi.Length()); 
System.Console.WriteLine("Width (in): {0}", boxi.Width()); 
System.Console.WriteLine("Length(cm): {0}", mDimensions.Length| 
System.Console.WriteLine("Width (cm): {0}", mDimensions.Width(: 
j 





i$ 


z^ 


CH 编程 指南 

类 和 结构 (CH 编程 指南 ) 

接口 (CH 编程 指南 ) 

如 何 : 显 式 实现 接口 成 员 (CH 编程 指南 ) 


互 操作 性 (CH 编程 指南 ) 


互 操作 性 使 您 能 够 保留 和 利用 在 现 有 非 托 管 代码 中 的 投入 。 运行 在 公共 语言 运行 时 
(CLR) 的 控制 之 下 的 代码 称 为 “托管 代码 ”运行 在 CLR 之 外 的 代码 称 为 “ 非 托管 代 
码 ” COM, COM+, C++ 组 件 、ActiveX 组 件 和 Microsoft Win32 API 都 是 非 托 管 
代码 的 示例 。 


.NET Framework 通过 平台 调用 服务 、System.Runtime.InteropServices 命名 空 
间 "al 互 操作 性 和 COM 互 操作 性 (COM 互 操 作 ) 来 实现 与 非 托管 代 码 的 互 操 
作 性 。 


本 节 内 容 


互 操作 性 概述 (CH 编程 指南 ) 

介绍 在 Cit 托管 代码 和 非 托 管 代码 之 间 进 行 互 操作 的 方法 。 

如 何 : 通过 使 用 Visual CH 功能 访问 Office 互 操 作对 象 (CH 编程 指南 ) 
描述 Visual C# 2010 中 引入 的 功能 以 便于 Office 编程 。 

如 何 : 在 COM 互 操作 编程 中 使 用 索引 属性 (CH 编程 指南 ) 

描述 如 何 使 用 索引 属性 以 访问 包含 参数 的 COM 属性 。 

如 何 : 使 用 平台 调用 播放 波形 文件 (C# 编程 指南 ) 

介绍 如 何 使 用 平台 调用 服务 在 Windows 操作 系统 中 播放 .wav 声音 文件 。 
演练 : Office 编程 (C# 和 Visual Basic) 

演示 如 何 创建 包含 一 个 指向 该 工作 簿 的 Excel TM Word 文档 。 
COM 类 示例 (CH 编程 指南 ) 

演示 如 何 将 C# 类 作为 COM 对 象 公开 。 


C# 语言 规范 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


演练 : Office 编程 (C# 和 Visual Basic) 
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参考 
Marshal.ReleaseComObject 
CH 编程 指南 

其 他 资源 


与 非 托管 代码 交互 操作 


互 操作 性 (CH 编程 指南 ) 


303 


互 操作 性 概述 (CH 编程 指责) 


本 主题 描述 在 C# 托管 和 非 托 管 代 码 之 间 实 现 互 操作 性 的 方法 。 


平台 调用 


平台 调用 是 一 种 服务 ， 它 使 托管 代码 可 以 调用 在 动态 链接 库 (DLL) (如 Microsoft 
Win32 API 中 的 那些 DLL) 中 实现 的 非 托管 丁 数 。 此 服务 将 查找 并 调用 导出 的 函 
数 ， 然 后 根据 需要 跨越 互 用 边界 封 送 其 参数 (整数 、 字 符 串 、 数 组 、 结 构 等 ) 。 


有 关 更 多 信息 ， 请 参见 使 用 非 托 管 DLL KAA 如 何 : 使 用 平台 调用 播放 波形 文件 
(C? 编程 指南 ) o 


y = 
Ef TER 


公共 语言 运行 时 (CLR) (CLR) 管理 对 系统 资源 的 访问 。 调 用 CLR 外 部 的 非 托管 
代码 会 避 开 此 安全 机 制 ， 因 此 会 带 来 安全 风险 。 例 如 ， 非 托管 代码 可 能 会 直接 

调用 非 托 管 代码 中 的 资源 ， 从 而 避 开 CLR 安全 机 制 ，。 有 关 更 多 信息 ， 请 参见 
.NET Framework Security (.NET Framework 安全 性 ) 。 


C++ Interop 


可 以 使 用 C++ Interop (又 称 为 It Just Works (IJW)) 包装 本 机 C++ 类 ， 使 得 用 CH 
或 其 他 .NET Framework 语言 编写 的 代码 可 以 使 用 它 。 为 此 ， 可 以 编写 C++ 代码 
来 包装 本 机 DLL 或 COM 组 件 。 与 其 他 .NET Framework 语言 不 同 ，Visual C++ 
支持 互 操作 性 ， 多 许 托管 代码 和 非 托 管 代 码 存在 于 同一 个 应 用 程序 中 ， 甚 至 存在 于 
同一 个 文件 中 。 然 后 ， 可 以 使 用 /clr 编译 器 开关 生成 C++ 代码 ， 从 而 生成 托管 程 
序 集 。 最 后 ， 在 CH 项 目 中 添加 一 个 对 该 程序 集 的 引用 ， 并 像 使 用 其 他 托管 类 那样 
使 用 被 包装 对 象 。 


向 C# 公开 COM 组 件 


可 以 使 用 CH 项 目 中 的 COM 组 件 。 一 般 步 又 如 下 所 示 : 


1. 找到 要 使 用 的 COM 组 件 并 注册 它 。 使 用 regsvr32.exe 注册 或 注销 COM 
DLL。 


2. 在 项 目 中 添加 对 COM 组 件 或 类 型 库 的 引用 。 


添加 引用 时 ，Visual Studio 会 用 到 Tlbimp.exe (类 型 库 导 入 程序 ) ， 后 者 将 类 
型 库 作 为 输入 并 输出 一 个 .NET Framework 互 操作 程序 集 。 该 程序 集 又 称 为 运 
行 时 可 调用 包装 (RCW)， 其 中 包含 了 包装 类 型 库 中 的 COM 类 和 接口 的 托管 类 
和 接口 。Visual Studio 将 生成 组 件 的 引用 添加 至 项 目 。 


3. 创建 在 ROW 中 定义 的 类 的 实例 。 而 这 样 会 创建 COM 对 象 的 实例 。 


4. 像 使 用 其 他 托管 对 象 那样 使 用 该 对 象 。 当 垃圾 回收 对 该 对 象 进行 回收 后 ，COM 
对 象 的 实例 也 会 从 内 存 中 释放 出 来 。 


有 关 更 多 信息 ， 请 参见 向 .NET Framework 公开 COM 组 件 。 


向 COM 公开 C 
COM 客户 端 可 以 使 用 已 经 正确 公开 的 C# 类 型 。 公 开 C# 类 型 的 基本 步骤 如 下 所 
人 小: 

1. 在 CH 项目 中 添加 互 操作 特性 。 


可 以 通过 修改 Visual C# 项 目 属性 使 程序 集 COM 可 见 。 有 关 更 多 信息 ， 请 参 
见 “ 程 序 集 信息 ”对话 框 。 


2. 生成 COM 类 型 库 并 对 它 进行 注册 以 供 COM 使 用 。 


可 以 修改 Visual C# 项 目 属 性 以 自动 注册 COM interop 的 C# 组 件 。Visual 
Studio 使 用 Regasm.exe (程序 集注 册 工 具 ) ， 方 法 是 使 用 /tlb 命令 行 切换 ， 
其 将 管理 的 组 件 作 为 输入 ， 以 生成 类 型 库 。 此 类 型 库 描述 程序 集中 的 public 
类 型 并 添加 注册 表 项 ， 以 便 COM 客户 端 可 以 创建 托管 类 。 


有 关 更 多 信息 ， 请 参见 向 COM 公开 .NET Framework 组 件 和 COM 类 示例 (CH 
编程 指南 ) 。 


请 参阅 

Improving Interop Performance 

Introduction to COM Interop 

Marshaling between Managed and Unmanaged Code 
与 非 托管 代码 交互 操作 

Advanced COM Interoperability 

C# 编程 指南 


如 何 : 通过 使 用 Visual C 功能 访问 Office 互 操 作 
对 象 (CH 编程 指南 ) 
Visual C£ 2010 引入 了 可 以 简化 对 Office API 对 象 的 访问 的 新 功能 。 这 些 新 功能 包 


括 命 名 实 参 和 可 选 实 参 、 名 为 dynamic 的 新 类 型 ， 以 及 在 COM 方法 中 将 实 参 传 
递 为 引用 形 参 (就 像 它们 是 值 形 参 ) 的 功能 。 


在 本 主题 中 ， 你 将 利用 这 些 新 功能 来 编写 创建 并 显示 Microsoft Office Excel 工作 表 
的 代码 。 然 后 ， 你 将 编写 添加 包含 链接 到 Excel 工作 表 的 图 标的 Office Word 文档 
的 代码 。 


若 要 完成 本 演练 ， 你 的 计算 机 上 必须 安装 Microsoft Office Excel 2007 和 Microsoft 
Office Word 2007 或 更 高 版 本 。 


如 果 你 使 用 的 操作 系统 早 于 Windows Vista， 请 确保 安装 .NET Framework 2.0。 
8 注意 


以 下 说 明 中 的 某 些 Visual Studio 用 户 界面 元 素 在 计算 机 上 出 现 的 名 称 或 位 置 可 
能 会 不 同 。 这 些 元 素 取决 于 你 所 使 用 的 Visual Studio 版 本 和 你 所 使 用 的 设置 。 
有 关 详 细 人 和 信息， 请 参阅 个 性 化 Visual Studio IDE, 


创建 新 的 控制 台 应 用 程序 


1. 启动 Visual Studio, 

2. 在 “文件 "菜单 上 ， 指 向 “新 建 ”， 然 后 单 击 “ 项 目 ”。 出 现 新 建 项 目 对 话 框 。 
3. 在 “已 安装 的 模板 ? 窗 格 中 ， 展 开 “Visual C#’, A X 4; "Windows", 
4 


.查看 “新 建 项 目 ” 对 话 框 的 顶部 ， 确 保 “.NET Framework 4” (或 更 高 版 本 ) 选 为 
目标 框架 。 


. 在 “模板 ” 窗 格 中 ， 单 击 “ 控 制 台 应 用 程序 ”。 
6. 在 “名 称 "字段 中 键入 项 目的 名 称 。 

7. 单 击 “确定 "。 

新 项 目 将 出 现在 “解决 方案 资源 管理 器 "中 。 


添加 引用 


1. 在 “解决 方案 资源 管理 器 * 中 ， 右 键 单 击 你 的 项 目 名 称 ， 然 后 单 击 “添加 引用 ”。 闻 
显示 “添加 引用 ”对 话 框 。 


Ol 


2. 在 “程序 集 " 页 上 ， 在 “组 件 名 称 ” 列 表 中 选择 “Microsoft.Office.Interop.Word”， 然 
后 按 住 Ctrl 键 并 选择 “Microsoft.Office.Interop.Excel"。 如 果 未 看 到 程序 集 ， 你 
可 能 需要 确保 安装 并 显示 它们 (参阅 如 何 : LR Office 主 互 操作 程序 集 ) 


3. 单 击 “确定 ”。 


添加 必要 的 Using 指令 
1. 在 "解决 方案 资源 管理 器 "中 ， 右 键 单 击 “Program.cs" 文 件 ， 然 后 单 击 “ 查 看 代 


码 "。 


2. 将 以 下 using 指令 添加 到 代码 文件 的 顶部 。 


using Excel = Microsoft.Office.Interop.Excel; 
using Word - Microsoft.Office.Interop.Word; 


创建 银行 帐户 列表 
1. 将 以 下 类 定义 粘贴 到 "Program.cs” 中 的 Program 类 下 。 


public class Account 


public int ID { get; set; } 
public double Balance { get; set; } 


2. 将 以 下 代码 添加 到 Main 方法 ， 以 创建 包含 两 个 帐户 的 bankAccounts 列表 。 


// Create a list of accounts. 
var bankAccounts = new List&lt;Account&gt; { 
new Account { 
ID = 345678, 
Balance = 541.27 
}, 
new Account { 
ID = 1230221, 
Balance - -127.44 
} 
u 


声明 将 帐户 信息 导出 到 Excel 的 方法 


1. 将 以 下 方法 添加 到 Program 类 以 设置 Excel 工作 表 。 


方法 Add 有 一 个 可 选 参数 ， 用 于 指定 特定 的 模板 。 如 果 希 望 使 用 形 参 的 默认 
值 ， 你 可 以 借助 可 选 形 参 (Visual C# 2010 中 新 增 ) 忽略 该 形 参 的 实 参 。 由 于 
以 下 代码 中 未 发 送 任何 参数 ，Add 将 使 用 默认 模板 并 创建 新 的 工作 筹 。C# 早 
期 版 本 中 的 等 效 语句 要 求 占 位 符 参 数 : 
ExcelApp.Workbooks.Add(Type.Missing). 


static void DisplayInExcel(IEnumerable&lt;Account&gt; accounts) 
{ 

var excelApp = new Excel.Application(); 

// Make the object visible. 

excelApp.Visible = true; 


// Create a new, empty workbook and add it to the collectic 
// by property Workbooks. The new workbook becomes the acti 
// Add has an optional parameter for specifying a praticule 
// Because no argument is sent in this example, Add creates 
excelApp.Workbooks.Add(); 


// This example uses a single workSheet. The explicit type 


// removed in a later procedure. 
Excel. Worksheet workSheet - (Excel.Worksheet)excelApp.Acti 


EEE) 





2. 在 DisplaylnExcel 的 末尾 添加 以 下 代码 。 代 码 将 值 插 入 工作 表 第 一 行 的 前 两 
列 。 


// Establish column headings in cells A1 and B1. 
workSheet.Cells[1, "A"] = "ID Number"; 
workSheet.Cells[1, "B"] = "Current Balance"; 


3. 在 DisplayInExcel 的 末尾 添加 以 下 代码 。 foreach fat PANE RU 
入 工作 表 连 续 行 的 前 两 列 。 


var row = 1; 
foreach (var acct in accounts) 


{ 
row++; 
workSheet.Cells[row, "A"] = acct.ID; 
workSheet.Cells[row, "B"] - acct.Balance; 
} 


4. 在 DisplayInExcel 的 末尾 添加 以 下 代码 以 将 列 宽 调 整 为 适合 内 容 。 


workSheet.Columns[1].AutoFit(); 
workSheet.Columns[2].AutoFit(); 


早期 版 本 的 C# 要 求 显 式 强 制 转换 这 些 操作 ， 因 为 ExcelApp.Columns[1] 返回 
Object，AutoFit 为 Excel Range 方法 。 以 下 各 行 显示 强制 转换 。 


((Excel.Range)workSheet.Columns[1]).AutoFit(); 
((Excel.Range)workSheet.Columns[2]).AutoFit(); 


如 果 程 序 集 由 /link 编译 器 选项 引用 或 者 如 果 Excel BS" ACER E HAY BNE 
E% true, W) Visual C£ 2010 及 更 高 版 本 会 自动 将 返回 的 Object 转换 为 
dynamic, True 是 此 属性 的 默认 值 。 


运行 项 目 
1. 在 Main 的 末尾 添加 以 下 行 。 


// Display the list in an Excel spreadsheet. 
DisplayInExcel(bankAccounts); 


2. 按 Ctrl+F5。 
出 现 包 含 两 个 帐户 数据 的 Excel 工作 表 。 


添加 Word 文档 


1. 若 要 说 明 Visual C# 2010 以 及 更 高 版 本 在 其 他 哪些 方面 增强 了 Office 编程 ， 
可 以 使 用 以 下 代码 打开 Word 应 用 程序 并 创建 链接 到 Excel 工作 表 的 图 标 。 


将 方法 CreatelconInWordDoc (在 此 步骤 后 面 提 供 ) 粘贴 到 Program 类 中 。 
CreatelconInWordDoc 利用 命名 参数 和 可 选 参数 来 降低 对 Add 和 
PasteSpecial 的 方法 调用 的 复杂 度 。 这 些 调用 合并 了 其 他 两 项 新 功能 ， 这 两 项 
新 功能 在 简化 对 具有 引用 参数 的 COM 方法 的 调用 的 Visual C£ 2010 中 引入 。 
首先 ， 你 可 以 将 实 参 发 送 到 引用 形 参 ， 就 像 它 们 是 值 形 参 一 样 。 即 ， 你 可 以 直 
接 发 送 值 ， 而 无 需 为 每 个 引用 参数 创建 变量 。 编 译 器 会 生成 临时 变量 以 保存 参 
并 将 在 你 从 调用 返回 时 丢弃 变量 。 其 次 ， 你 可 以 忽略 参数 列表 中 的 ref 
键 字 。 


Add 方法 有 四 个 引用 参数 ， 所 有 引用 参数 都 是 可 选 的 。 在 Visual C# 2010 或 
更 高 版 本 中 ， 如 果 和 希望 使 用 其 默认 值 ， 可 以 忽略 任何 或 所 有 形 参 的 实 参 。 在 
Visual C£ 2008 以 及 更 早 版 本 中 ， 由 于 形 参 是 引用 形 参 ， 因 此 必须 为 每 个 形 参 
提供 实 参 且 实 参 必 须 是 变量 。 


PasteSpecial 方法 可 插入 剪贴 板 的 内 容 。 该 方法 有 七 个 引用 参数 ， 所 有 引用 
参数 都 是 可 选 的 。 以 下 代码 为 其 中 两 个 形 参 指定 实 参 : Link 用 于 创建 指向 剪贴 
板 内 容 源 的 连接 ，DisplayAslcon 用 于 将 链接 显示 为 图 标 。 在 Visual C# 2010 
中 ， 你 可 以 对 其 中 两 个 形 参 使 用 命名 实 参 而 忽略 其 他 形 参 。 尽 管 这 些 是 引用 形 
参 ， 你 也 不 必 使 用 ref 关键 字 ， 或 者 创建 变量 以 实 参 形式 发 送 。 你 可 以 直接 发 


送 值 。 在 Visual C# 2008 以 及 早期 版 本 中 ， 你 必须 为 每 个 引用 形 参 发 送 变量 实 
参 


Zo 


static void CreateIconInwordDoc( ) 

{ 
var wordApp = new Word.Application(); 
wordApp.Visible = true; 


// The Add method has four reference parameters, all of whi 
// optional. Visual C# 2010 allows you to omit arguments fc 
// the default values are what you want. 
wordApp.Documents.Add(); 


// PasteSpecial has seven reference parameters, all of whic 
// optional. This example uses named arguments to specify v 
// for two of the parameters. Although these are reference 
// parameters, you do not need to use the ref keyword, or t 
// variables to send in as arguments. You can send the valt 
wordApp.Selection.PasteSpecial( Link: true, DisplayAsIcon: 


ES 和 天 





在 Visual C£ 2008 或 早期 版 本 的 语言 中 ， 需 要 以 下 更 复杂 的 代码 。 


static void CreatelconInWordDoc2008() 


{ 
var wordApp = new Word.Application(); 
wordApp.Visible = true; 
// The Add method has four parameters, all of which are opt 
// In Visual C# 2008 and earlier versions, an argument has 
// for every parameter. Because the parameters are referenc 
// parameters of type object, you have to create an object 
// for the arguments that represents 'no value' 
object useDefaultValue = Type.Missing; 
wordApp.Documents.Add(ref useDefaultValue, ref useDefaultVe 
ref useDefaultValue, ref useDefaultValue); 

// PasteSpecial has seven reference parameters, all of whic 
// optional. In this example, only two of the parameters re 
// specified values, but in Visual C£ 2008 an argument must 
// for each parameter. Because the parameters are reference 
// you have to contruct variables for the arguments. 
object link - true; 
object displayAsIcon - true; 
wordApp.Selection.PasteSpecial( ref useDefaultValue, 

ref link, 

ref useDefaultValue, 

ref displayAsIcon, 

ref useDefaultValue, 

ref useDefaultValue, 

ref useDefaultValue); 

j 


" Ă— 
2. f£ Main 的 未 尾 添加 以 下 语句 。 





// Create a Word document that contains an icon that links to 
// the spreadsheet. 
CreateIconInwordDoc(); 


了 S DL 
3. 在 DisplaylnExcel 的 末尾 添加 以 下 语句 。 Copy 方法 可 将 工作 表 添 加 到 剪贴 


o 


// Put the spreadsheet contents on the clipboard. The Copy metr 
// optional parameter for specifying a destination. Because no 
// is sent, the destination is the Clipboard. 

workSheet .Range["A1:B3"].Copy( ); 


«| 











4. 1& Ctrl F5, 
将 出 现 包 含 图 标的 Word XH NA EE ER EURETL lE IET BU GI 


x IB BRA E ERE X Blt 


， 当 调用 运行 时 不 需要 主 互 操 作 程序 集 (PIA) 的 COM 类 型 时 ， 可 能 实现 其 他 增 
o WIR PIA 的 依赖 项 可 实现 版 本 独立 性 并 且 更 易于 部 署 。 有 关 不 使 用 PIA 编 
程 的 优势 的 详细 信息 ， 请 参阅 演练 : 艾 入 托管 程序 集中 的 类 型 (CZ 和 Visual 
Basic) 。 


此 外 ， 由 于 可 以 通过 使 用 类 型 dynamic (而 非 Object) 表示 COM 方法 必需 
TENDS 类 型 ， 因 此 更 易于 编程 。 具 有 类 型 dynamic 的 变量 在 运行 时 以 前 均 

会 计算 ， 从 而 消除 了 显 式 强制 转换 的 需要 。 有 关 详 细 信 息 ， 请 参阅 使 用 类 型 
its (CH 编程 指南 ) 。 


在 Visual C£ 2010 中 ， 黑 认 行 为 是 嵌入 类 型 信息 ， 而 不 是 使 用 PIA。 由 于 该 默 
认 行 为 ， 因 此 不 需要 显 式 强 制 转 换 ， 之 前 的 几 个 示例 也 得 到 简化 。 例 如 ， 
DisplayInExcel 中 worksheet 的 声明 会 写 为 Excel. Worksheet workSheet = 
excelApp.ActiveSheet 而 非 Excel. Worksheet workSheet = 
(Excel.Worksheet)excelApp.ActiveSheet。 在 相同 方法 中 对 AutoFit 的 调用 还 
将 要 求 在 不 进行 默认 行为 的 情况 下 显 式 强制 转换 ， 因 为 ExcelApp.Columns[1] 
返回 Object， 并 且 AutoFit 为 Excel 方法 。 以 下 代码 显示 强制 转换 。 


((Excel.Range)workSheet.Columns[1]).AutoFit(); 
((Excel.Range)workSheet.Columns[2]).AutoFit(); 


2. 若 要 更 改 默认 行为 并 使 用 PIA RERA X Ef, ARF BECA SERES ER 
器 "中 的 “引用 ”节点 ， 然 后 选 
择 “Microsoft.Office.Interop.Exce[* 或 “Microsoft.Office.Interop.Word”。 

3. 如 果 看 不 到 “属性 ”窗口 ， 请 按 “"F4”。 


4. 在 属性 列表 中 找到 “ 找 入 互 操作 类 型 "”， 将 其 值 更 改 为 "False"。 同 样 地 ， 你 还 可 
以 通过 在 命令 提示 符 下 使 用 /reference 编译 器 选项 代替 /link 进行 编译 。 


将 其 他 格式 添加 到 表格 


1. 将 在 DisplayInExcel 中 对 AutoFit 的 两 个 调用 替换 为 以 下 语句 。 


// Call to AutoFormat in Visual C£ 2010. 
workSheet.Range["A1", "B3"].AutoFormat ( 
Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2); 


AutoFormat 方法 有 七 个 值 参 数 ， 每 个 值 参数 都 是 可 选 的 。 使 用 命名 参数 和 可 
选 参数 ， 你 可 以 为 这 些 参 数 中 的 所 有 或 部 分 提供 参数 ， 也 可 以 不 为 它们 中 的 任 
何 一 个 提供 。 在 上 一 条 语句 中 ， 仅 为 其 中 一 个 形 参 Format 提供 实 参 。 由 于 
Format 是 参数 列表 中 的 第 一 个 参数 ， 因 此 无 需 提供 参数 名 称 。 但 是 ， 如 果 包 
含 参数 名 称 ， 语 句 则 可 能 更 易于 理解 ， 如 以 下 代码 所 示 。 


// Call to AutoFormat in Visual C£ 2010. 
workSheet.Range["A1", "BS3"].AutoFormat(Format: 
Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2); 


2. SR Ctrl+F5 查看 结果 。 其 他 格式 在 XIRangeAutoFormat 枚 举 中 列 出 。 


3. 将 步骤 1 中 的 语句 与 以 下 代码 比较 (以 下 代码 显示 Visual C# 2008 或 早期 版 
本 中 要 求 的 参数 ) 。 


// The AutoFormat method has seven optional value parameters. T 
// following call specifies a value for the first parameter, ar 
// the default values for the other six. 


// Call to AutoFormat in Visual C£ 2008\. This code is not part 

// current solution. 

excelApp.get Range("A1", "B4").AutoFormat(Excel.XlRangeAutoForm 
Type.Missing, Type.Missing, Type.Missing, Type.Missing, Tyr 
Type.Missing); 


以 下 代码 显示 完整 示例 。 





using System; 

using System.Collections.Generic; 

using System.Ling; 

using Excel - Microsoft.Office.Interop.Excel; 
using Word = Microsoft.Office.Interop.Word; 


namespace OfficeProgramminwalkthruComplete 


{ 
class Walkthrough 


{ 


static void Main(string[] args) 


// Create a list of accounts. 
var bankAccounts = new List<Account> 


{ 


j 


new Account ( 
ID = 345678, 
Balance - 541.27 
ty 
new Account { 
ID = 1230221, 
Balance = -127.44 


} 
H 


// Display the list in an Excel spreadsheet. 
DisplayInExcel(bankAccounts); 


// Create a Word document that contains an icon that l: 
// the spreadsheet. 
CreatelIconInWordDoc(); 


static void DisplayInExcel(IEnumerable<Account> accounts) 


i 


var excelApp = new Excel.Application(); 
// Make the object visible. 
excelApp.Visible - true; 


// Create a new, empty workbook and add it to the colle 
// by property Workbooks. The new workbook becomes the 
// Add has an optional parameter for specifying a prat: 
// Because no argument is sent in this example, Add cre 
excelApp.Workbooks.Add(); 


// This example uses a single workSheet. 
Excel. Worksheet workSheet - excelApp.ActiveSheet; 


// Earlier versions of C£ require explicit casting. 
//Excel. Worksheet workSheet = (Excel.Worksheet)excelA| 


// Establish column headings in cells A1 and B1. 
workSheet.Cells[1, "A"] = "ID Number"; 
workSheet.Cells[1, "B"] = "Current Balance"; 


var row = 1; 
foreach (var acct in accounts) 


{ 
rowt++; 
workSheet.Cells[row, "A"] = acct.ID; 
workSheet.Cells[row, "B"] - acct.Balance; 
j 


workSheet.Columns[1].AutoFit(); 
workSheet.Columns[2].AutoFit(); 


// Call to AutoFormat in Visual C£ 2010\. This statemer 
// two calls to AutoFit. 


workSheet.Range["A1", "B3"].AutoFormat ( 
Excel.XlRangeAutoFormat.xlRangeAutoFormatClassic2), 


// Put the spreadsheet contents on the clipboard. The ( 
// optional parameter for specifying a destination. Bec 
// is sent, the destination is the Clipboard. 

workSheet .Range["A1:B3"].Copy(); 


} 
static void CreateIconInwordDoc() 
{ 
var wordApp = new Word.Application(); 
wordApp.Visible = true; 
// The Add method has four reference parameters, all o! 
// optional. Visual C£ 2010 allows you to omit argument 
// the default values are what you want. 
wordApp.Documents.Add(); 
// PasteSpecial has seven reference parameters, all of 
// optional. This example uses named arguments to spec: 
// for two of the parameters. Although these are refert 
// parameters, you do not need to use the ref keyword, 
// variables to send in as arguments. You can send the 
wordApp.Selection.PasteSpecial(Link: true, DisplayAsIc: 
} 
} 
public class Account 
{ 
public int ID { get; set; } 
public double Balance { get; set; } 
} 
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Type.Missing 

dynamic (C# 参考 ) 

使 用 类 型 dynamic (C£ 编程 指南 ) 

命名 实 参 和 可 选 实 参 (C# 编程 指南 ) 

如 何 : 在 Office 编程 中 使 用 命名 参数 和 可 选 参数 (CH 编程 指南 ) 


如 何 : 在 COM 互 操作 编程 中 使 用 索引 属性 (CH 编 
程 指南 ) 


索引 属性 改进 了 在 CH 编程 中 使 用 具有 参数 的 COM 属性 的 方式 。 将 索引 属性 与 
Visual C£ 2010 中 引入 的 其 他 功能 〈 如 命名 参数 和 可 选 参数 、 新 的 dynamic 类 型 以 
及 侈 入 的 类 型 信息 ) 一 起 使 用 ， 可 增强 Microsoft Office 编程 功能 。 


在 早期 版 本 的 C# 中 ， 只 有 在 get 方法 不 具有 任何 参数 且 set 方法 有 且 仅 有 一 个 值 
参数 时 ， 才 能 将 方法 作为 属性 进行 访问 。 但 是 ， 并 非 所 有 COM 属性 都 符合 上 述 限 
制 。 例 如 ，Excel 的 Range 属性 具有 一 个 get 访问 器 ， 该 访问 器 需要 一 个 表示 范围 
名 称 的 参数 。 以 前 ， 由 于 您 无 法 直接 访问 Range 属性 ， 因 此 您 必须 改 用 
get_Range 方法 ， 如 以 下 示例 所 示 。 


// Visual C£ 2008 and earlier. 
var excelApp - new Excel.Application(); 
OA 


Excel.Range targetRange = excelApp.get Range("A1", Type.Missing); 


anres —H——ÀÁg 'angenqqns 7e): 
利用 索引 属性 ， 您 可 以 改 为 编写 以 下 代码 : 


// Visual C£ 2010. 


var excelApp - new Excel.Application(); 
OA 


Excel.Range targetRange = excelApp.Range["A1"]; 


-rn lITCGIEER 
Ef TER 


上 面 的 示例 还 使 用 可 选 参数 功能 (在 Visual C# 2010 中 引入 ) ， 此 功能 可 使 您 
忽略 Type.Missing。 


与 此 类 似 ， 若 要 在 Visual C# 2008 及 更 里 版 本 中 设置 Range 对 象 的 Value 属性 的 
值 ， 需 要 两 个 参数 。 一 个 参数 为 用 于 指定 范围 值 的 类 型 的 可 选 形 参 提供 实 参 。 另 一 
个 参数 提供 Value 属性 的 值 。 在 Visual C£ 2010 之 前 的 版 本 中 ，C# 仅 人 允许 一 个 参 
数 。 因 此 ， 您 必须 使 用 set Value 方法 ， 或 者 使 用 另 一 个 属性 Value2， 而 不 能 使 

用 常规 的 set 方法 。 下 面 的 示例 演示 了 这 些 技术 。 这 两 种 技术 都 将 A1 单元 格 的 值 

设置 为 Name。 


// Visual C# 2008. 


targetRange.set Value(Type.Missing, "Name"); 
// Or 
targetRange.Value2 = "Name"; 


利用 索引 属性 ， 您 可 以 改 为 编写 以 下 代码 。 


// Visual C# 2010. 
targetRange.Value - "Name"; 


您 不 能 创建 自己 的 索引 属性 。 该 功能 只 支持 使 用 现 有 的 索引 属性 。 


下 面 的 代码 显示 一 个 完整 的 示例 。 有 关 如 何 设置 访问 Office API 的 项 目的 更 多 信 
息 ， 请 参见 如 何 : 通过 使 用 Visual CH 功能 访问 Office 互 操作 对 象 (CH 编程 指 
FJ. s 


// You must add a reference to Microsoft.Office.Interop.Excel to ri 


// this example. 
using System; 
using Excel - Microsoft.Office.Interop.Excel; 


namespace IndexedProperties 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
CSharp2010(); 
//CSharp2008( ); 
} 
static void CSharp2010() 
{ 
var excelApp = new Excel.Application(); 
excelApp.Workbooks.Add(); 
excelApp.Visible - true; 
Excel.Range targetRange - excelApp.Range["A1"]; 
targetRange.Value - "Name"; 
} 
static void CSharp2008() 
{ 
var excelApp = new Excel.Application(); 
excelApp.Workbooks.Add(Type.Missing); 
excelApp.Visible - true; 
Excel.Range targetRange = excelApp.get Range("A1", Type 
targetRange.set Value(Type.Missing, "Name"); 
// Or 
//targetRange.Value2 - "Name"; 
} 
} 
} 





命名 实 参 和 可 选 实 参 (CH 编程 指南 ) 

dynamic (C£ 参考 ) 

使 用 类 型 dynamic (C£ 编程 指南 ) 

如 何 : 在 Office 编程 中 使 用 命名 参数 和 可 选 参数 (CH 编程 指南 ) 
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如 何 : 通过 使 用 Visual C# 功能 访问 Office 互 操 作对 象 (CH 编程 指南 ) 
演练 : Office 编程 (C# 和 Visual Basic) 


如 何 : 在 COM 互 操作 编程 中 使 用 索引 属性 (CH 编程 指南 ) 319 


如 何 : 使 用 平台 调用 播放 波形 文件 〈C# 编程 指南 ) 


下 面 的 C# 代码 示例 演示 如 何在 Windows 操作 系统 上 使 用 平台 调用 服务 来 播放 波 
形声 音 文 件 。 


此 代码 示例 使 用 Dillmport 将 winmm.dll 的 PlaySound 方法 入 口 点 作为 Form1 
PlaySound() 导入 。 该 示例 具有 一 个 带 有 一 个 按钮 的 简单 Windows 窗 体 。 单 击 该 按 
钮 可 打开 标准 Windows OpenFileDialog 对 话 框 ， 以 便 打开 要 播放 的 文件 。 选 择 波 
形 文 件 后 ， 将 使 用 winmm.DLL 程序 集 方法 的 PlaySound() 方法 来 播放 此 文件 。 有 
X winmm.dll 的 PlaySound 方法 的 更 多 信息 ， 请 参见 Using the PlaySound 
function with Waveform-Audio Files (使 用 PlaySound 画 数 播放 波形 音频 文件 ) o 
浏览 并 选择 一 个 带 .wav 扩展 名 的 文件 ， 然 后 单 击 “ 打 开 ” 以 使 用 平台 调用 播放 该 波 
形 文件 。 将 在 文本 框 中 显示 选择 的 文件 的 完整 路 径 。 


“打开 文件 "对话 框 料 使 用 以 下 筑 选 器 设置 只 显示 具有 wav 扩展 名 的 文件 : 


dialogi.Filter = "Wav Files (*.wav)|*.wav"; 


using System.Windows.Forms; 
using System.Runtime.InteropServices; 


namespace WinSound 


{ 
public partial class Formi Form 
{ 
private TextBox textBox1; 
private Button button1; 
public Formi() //constructor 
{ 
InitializeComponent(); 
j 
[System.Runtime.InteropServices.DllImport("winmm.DLL", Enti 
private static extern bool PlaySound(string szSound, Syster 
[System.Flags] 
public enum PlaySoundFlags int 
{ 
SND SYNC = 0x0000, 
SND ASYNC - 0x0001, 
SND NODEFAULT = 0x0002, 
SND LOOP - 0x0008, 
SND NOSTOP = 0x0010, 
SND NOWAIT = 0x00002000, 
SND FILENAME = 0x00020000, 
SND RESOURCE - 0x00040004 
j 
private void buttoni Click (object sender, System.EventArg: 
{ 
OpenFileDialog dialogi = new OpenFileDialog(); 
dialogi.Title = "Browse to find sound file to play"; 
dialogi.InitialDirectory = @"c:\"; 
dialogi.Filter = "Wav Files (*.wav)|*.wav"; 
dialogi.FilterIndex = 2; 
dialogi.RestoreDirectory = true; 
if(dialogi.ShowDialog() == DialogResult.OK) 
{ 
textBox1.Text = dialog1.FileName; 
PlaySound (dialogi.FileName, new System.IntPtr(), F 
j 
j 
j 











编译 代码 


编译 代码 


1. f£ Visual Studio 中 创建 一 个 新 的 C£ Windows 应 用 程序 项 目 ， 并 命名 为 


WinSound。 
2. 复制 上 面 的 代码 并 将 其 粘贴 到 Form1.cs 文件 中 以 覆盖 原来 的 内 容 。 


3. 复制 下 面 的 代码 ， 并 将 它 粘贴 到 Form1.Designer.cs 文件 的 
InitializeComponent() 方法 中 现 有 代码 的 后 面 。 


this.button1 = new System.Windows.Forms.Button(); 
this.textBox1 = new System.Windows.Forms.TextBox(); 
this.SuspendLayout(); 

// 

// buttoni 

// 


this.button1.Location = new System.Drawing.Point(192, 40); 


this.buttoni.Name = "button1"; 
this.buttoni.Size = new System.Drawing.Size(88, 24); 
this.buttoni.TabIndex - 0; 


this.button1.Text = "Browse"; 

this.buttoni.Click += new System.EventHandler(this.buttoni Clic 
// 

// textBox1 

// 


this.textBox1.Location = new System.Drawing.Point(8, 40); 


this.textBox1.Name = "textBox1"; 
this.textBox1.Size = new System.Drawing.Size(168, 20); 
this.textBox1.TabIndex = 1; 
this.textBox1.Text = "FIle path"; 
// 

// Formi 

// 


this.AutoScaleDimensions - new System.Drawing.SizeF(5, 13); 


this.ClientSize - new System.Drawing.Size(292, 266); 
this.Controls.Add(this.textBox1); 
this.Controls.Add(this.button1); 

this.Name = "Formi"; 

this.Text = "Platform Invoke WinSound CZ"; 
this.ResumeLayout (false); 

this.PerformLayout(); 


SSS EE aa 


4. 编译 并 运行 代码 。 


.NET Framework 安全 性 
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有 关 更 多 信息 ， 请 参见 NET Framework Security (.NET Framework 安全 性 ) , 


请 参阅 

CH 编程 指南 

互 操作 性 概述 (CH 编程 指南 ) 
互 操作 性 概述 (CH 编程 指南 ) 

A Closer Look at Platform Invoke 


用 平台 调用 封 送 数据 


如 何 : 使 用 平台 调用 播放 波形 文件 (CH 编程 指南 ) 


演练 : Office 编程 (C# 和 Visual Basic) 
Visual Studio 2010 在 C# 和 Visual Basic 中 引入 了 改进 Microsoft Office 编程 的 新 
功能 。 每 种 语言 都 增加 了 其 他 语言 中 已 经 存在 的 功能 。 


CH 中 的 新 功能 包括 命名 参数 和 可 选 参数 、 具 有 dynamic 类 型 的 返回 值 ， 以 及 在 
COM 编程 中 忽略 ref 关键 字 和 访问 索引 属性 的 功能 。Visual Basic 中 的 新 功能 包括 
自动 实现 的 属性 、Lambda 表达 式 语 句 和 集合 初始 值 设 定 项 。 


两 种 语言 都 支持 嵌入 类 型 信息 ， 从 而 允许 在 不 向 用 户 的 计算 机 部 署 主 互 操作 程序 集 
(PIA) 的 情况 下 部 署 与 COM 组 件 交 互 的 程序 集 。 有 关 详 细 信 息 ， 请 参阅 演练 : NA 
和 人 托管 程序 集中 的 类 型 (C# 和 Visual Basic) 。 


本 演练 演示 Office 编程 环境 中 的 新 功能 ， 但 这 些 新 功能 在 常规 编程 中 也 极为 有 用 。 
在 本 演练 中 ， 你 将 首先 使 用 Excel 外 接应 用 程序 来 创建 Excel TFE., AA, MY 
创建 包含 工作 簿 链接 的 Word 文档 。 最 后 ， 你 将 看 到 可 以 如 何 开启 和 关闭 PIA 依赖 


项 。 


系统 必 备 

若 要 完成 本 演练 ， 你 的 计算 机 上 必须 安装 有 Microsoft Office Excel 2013 (或 者 

2007 或 更 高 版 本 ) 和 Microsoft Office Word 2013 (或 者 2007 或 更 高 版 本 ) 。 

如 果 你 使 用 的 操作 系统 早 于 Windows Vista， 请 确保 安装 .NET Framework 2.0。 
区 注意 


以 下 说 明 中 的 某 些 Visual Studio A 户 界面 元 素 在 计算 机 上 出 现 的 名 称 或 位 置 可 
能 会 不 同 。 这 些 元 素 取 决 于 你 所 使 用 的 Visual Studio 版 本 和 你 所 使 用 的 设置 。 
有 关 详 细 信 息 ， 请 参阅 个 性 化 Visual Studio IDE, 


设置 Excel 外 接应 用 程序 


1. 启动 Visual Studio, 
. 在 “文件 ”菜单 上 ， 指 向 “新 建 ”"， 然 后 单 击 “ 项 目 ”。 


. 在 “安装 的 模板 " 窗 格 中 ， 展 开 “Visual Basic” 或 “Visual C#’, SRR “Office”, 25 
后 单 击 “2013”( 或 “2010” 或 “2007”) 。 


4. 在 “模板 " 窗 格 中 ， 单 击 “Excel 2013 外 接应 用 程序 ”( 或 “Excel 2010 外 接应 用 程 
Fr’ “Excel 2007 外 接应 用 程序 ”) 。 


5. 查看 “模板 " 窗 格 的 项 部， 确保 “.NET Framework 4” 或 更 高 版 本 出 现在 “目标 框 
架 " 框 中 。 


oO N 


6. 如 果 需 要 ， 在 “名 称 ” 框 中 键入 项 目的 名 称 。 
7. 单 击 “确定 ”。 
8. 新 项 目 将 出 现在 “解决 方案 资源 管理 器 "中 。 


添加 引用 


1. 在 "解决 方案 资源 管理 器 ” 中 ， 右 键 单 击 你 的 项 目 名 称 ， 然 后 单 击 “添加 引用 ”。 将 
Xm “添加 引用 ”对 话 框 。 


2. 在 “程序 集 ” 选 项 卡 上 ， 在 “组 件 名 称 ” 列 表 中 选 
择 “Microsoft.Office.Interop.Excel" 版 本 15.0.0.0 (针对 Excel 2010， 选 择 版 本 
14.0.0.0 ; 针对 Excel 2007， 选 择 版 本 12.0.0.0) ， 然 后 按 住 Ctrl 键 并 选 
择 “Microsoft.Office.Interop.Word” 版 本 15.0.0.0 (针对 Word 2010， 选 择 版 本 
14.0.0.0 ; 针对 Word 2007， 选 择 版 本 12.0.0.0) 。 如 果 未 看 到 程序 集 ， 你 可 
能 需要 确保 安装 并 显示 它们 (参阅 如 何 : 安装 Office 主 互 操 作 程 序 集 ) 。 


3. 单 击 “ 确 定 ”。 


添加 必要 的 Imports 话 句 或 using 指 今 
1. 在 “解决 方案 资源 管理 器 "中 ， 右 键 单 击 “ThisAddln.vb” 或 ‘ThisAddin.cs” 文 件 ， 
然后 单 击 " 查看 代码 "。 


2. 将 以 下 Imports 语句 (Visual Basic) 或 using 指令 (C#) 添加 到 代码 文件 的 顶 
部 〈 如 果 不 存在 ) 。 


VB 


using System.Collections.Generic; 
using Excel - Microsoft.Office.Interop.Excel; 
using Word = Microsoft.Office.Interop.Word; 


创建 银行 帐户 列表 


1. E 解决 方案 次 源 管理 器 * 中 ， 右 键 单 击 你 的 项 目 名 称 ， 单 击 “ 添 加 ”， 然 后 单 
o 如 果 使 用 的 是 Visual Basic， 则 将 类 命名 为 Account.vb ; 如 果 使 用 的 
是 cH 则 将 类 命名 为 Account.cs。 单 击 “ 添 加 ”。 


2. 将 Account 类 的 定义 替换 为 以 下 代码 。 类 定义 使 用 “自动 实现 的 属性 ” 
Visual Studio 2010 中 ， 是 Visual Basic 的 新 功能 。 有 关 详 细 信 息 ， 请 参阅 自 
动 实现 的 属性 (Visual Basic), 


VB 


class Account 


public int ID ( get; set; } 
public double Balance { get; set; } 


3. 若 要 创建 包含 两 个 帐户 的 bankAccounts 列表 ， 请 将 以 下 代码 添加 到 
ThisAddln.vb 或 ThisAddln.cs 中 的 ThisAddInStartup 方法 。 列 表 声 明 使 用 “ 集 
合 初始 值 设 定 项 ”， 在 Visual Studio 2010 中 ， 是 Visual Basic 的 新 功能 。 有 
关 详 细 信 息 ， 请 参阅 集合 初始 值 设 定 项 (Visual Basic), 


VB 


var bankAccounts = new List&lt;Account&gt; 


{ 
new Account 
ID = 345, 
Balance = 541.27 
Fo 
new Account 
ID = 123, 
Balance = -127.44 
} 
E 


将 数据 导出 到 Excel 


1. 在 相同 的 文件 中 ， 将 以 下 方法 添加 到 ThisAddln X, 该 方法 设置 Excel 工作 薄 
并 将 数据 导出 到 工作 筹 。 


VB 


void DisplayInExcel(IEnumerable&lt;Account&gt; accounts, 
Action&lt;Account, Excel.Range&gt; DisplayFunc) 


{ 
var excelApp = this.Application; 
// Add a new Excel workbook. 
excelApp.Workbooks.Add(); 
excelApp.Visible - true; 
excelApp.Range["Ai"].Value = "ID"; 
excelApp.Range["Bi1"].Value = "Balance"; 
excelApp.Range["A2"].Select(); 
foreach (var ac in accounts) 
{ 
DisplayFunc(ac, excelApp.ActiveCell); 
excelApp.ActiveCell.Offset[1, 0].Select(); 
} 
// Copy the results to the Clipboard. 
excelApp.Range["A1:B3"].Copy(); 
} 


此 方法 使 用 C# 的 两 项 新 功能 。Visual Basic 中 已 存在 这 两 项 功能 。 


o 方法 Add 有 一 个 “可 选 参数 ” 用 于 指定 特定 的 模板 。 如 果 希 望 使 用 形 参 的 
默认 值 ， 你 可 以 借助 可 选 形 参 (Visual C£ 2010 中 新 增 ) 忽略 该 形 参 的 实 
参 。 由 于 上 一 个 示例 中 未 发 送 任何 参数 ，Add 将 使 用 默认 模板 并 创建 新 的 
IF., CH 早期 版 本 中 的 等 效 语句 要 求 占 位 符 参 数 : 
excelApp.Workbooks.Add(Type.Missing). 


有 关 详 细 信 息 ， 请 参阅 命名 实 参 和 可 选 实 参 (CH 编程 指南 ) o 

o Range 对 象 的 Range 和 Offset 属性 使 用 “索引 属性 功能。 此 功能 允许 你 
通过 以 下 典型 C# 语法 从 COM 类 型 使 用 这 些 属性 。 索 引 属 性 还 允许 你 使 
用 Range 对 象 的 Value 属性 ， 因 此 不 必 使 用 Value2 属性 。 Value 属性 


ES en 但 索引 是 可 选 的 。 在 以 下 示例 中 ， 可 选 参数 和 索引 属性 配合 
用 。 


// Misual C£ 2010 provides indexed properties for COM progr 
excelApp.Range["Ai"].Value = "ID"; 
excelApp.ActiveCell.Offset[1, 0].Select(); 


E E s 
在 早期 版 本 的 语言 中 ， 需 要 以 下 特殊 语法 。 





// In Visual C£ 2008, you cannot access the Range, Offset, 
// properties directly. 

excelApp.get Range("A1").Value2 = "ID"; 
excelApp.ActiveCell.get Offset(1, 0).Select(); 











你 不 能 创建 自己 的 索引 属性 。 该 功能 仅 支持 使 用 现 有 索引 属性 。 


有 关 详 细 人 信息， 请 参阅 如 何 : 在 COM 互 操 作 编 程 中 使 用 索引 属性 (C# 
编程 指南 ) o 


2. 在 DisplayInExcel 的 末尾 添加 以 下 代码 以 将 列 宽 调 整 为 适合 内 容 。 
VB 


excelApp.Columns[1].AutoFit(); 
excelApp.Columns[2].AutoFit(); 


这 些 添加 展示 C# 2010 中 的 另 一 项 新 功能 : 4:38) COM 主机 返回 的 Object 
- (如 Office) ， 就 像 它 们 具有 dynamic X Æ — 34. SÁ"BR A E ERE E W E 
其 默认 值 True 时 ， 或 者 由 /link 编译 器 选项 引用 程序 集 时 ， 自 动 发 生 这 种 情 
he 键入 dynamic 允许 后 期 绑 定 (Visual Basic 已 提供 该 功能 ) 并 可 避免 
Visual C# 2008 和 早期 版 本 的 语言 中 要 求 的 显 式 强制 转换 。 


例如 ，excelApp.Columns[1] 返回 Object， 并 且 AutoFit 是 Excel 的 Range 
方法 。 如 果 没 有 dynamic， 你 必须 将 excelApp.Columns[1] 返回 的 对 象 强 制 转 
换 为 Range 的 实例 ， 然 后 才能 调用 AutoFit 方法 。 


// Casting is required in Visual C£ 2008. 
((Excel.Range)excelApp.Columns[1]).AutoFit(); 


// Casting is not required in Visual C£ 2010. 
excelApp.Columns[1].AutoFit(); 


BARA RRR WFR, d$ Wd wem si PIAS! 
用 ”和 "还原 PIA 依赖 项 程序。 有 关 dynamic 的 详细 信息 ， 请 参阅 
dynamic (C£ 参考 ) 或 使 用 类 型 dynamic (CZ 编程 指南 ) 。 


调用 DisplayInExcel 


1. f£ ThisAddIn StartUp 方法 的 末尾 添加 以 下 代码 。 对 DisplayInExcel 的 调用 包 
含 两 个 参数 。 第 一 个 参数 是 要 义理 的 帐户 列表 的 名 称 。 第 二 个 参数 是 定义 如 何 
处 理 数据 的 多 行 lambda 表达 式 。 每 个 帐户 的 ID 和 值 都 显示 在 相 邻 
的 单元 格 中 ， 如 果 余 额 小 于 需 ， 则 相应 的 行 显示 为 oes T lambda 表达 式 
是 Visual Basic 2010 中 的 新 功能 。 有 关 详 细 信息 ， 请 参阅 ou 表达 式 
(Visual Basic)。 


VB 


DisplayInExcel(bankAccounts, (account, cell) -&gt; 
// This multiline lambda expression sets custom processing rule 
// for the bankAccounts. 
{ 
cell.Value = account. ID; 
cell.offset[0, 1].Value = account.Balance; 
if (account.Balance &lt; 0) 


cell.Interior.Color = 255; 
cell.Offset[0, 1].Interior.Color = 255; 





2. 若 要 运行 程序 ， 请 按 F5. Hu OA PUER Excel 工作 表 。 


添加 Word 文档 


1. 在 ThisAddln_StartUp 方法 末尾 添加 以 下 代码 ， 以 创建 包含 指向 Excel 工作 簿 
的 链接 的 Word 文档 。 


VB 


var wordApp = new Word.Application(); 

wordApp.Visible - true; 

wordApp.Documents.Add(); 

wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true) 


此 代码 展示 CH 中 的 几 项 新 功能 : TE COM 编程 中 忽略 ref 的 功能 、 命 名 参数 
以 及 可 选 参数 。Visual Basic 中 已 存在 这 些 功能 。 PasteSpecial 方法 有 七 个 参 
数 ， 每 个 参数 都 是 可 选 引 用 参数 。 在 Visual C£ 2010 之 前 ， 你 必须 为 这 七 个 形 
E rs 即使 你 没有 有 意义 的 值 发 送 。 通 过 命名 实 参 和 可 

， 你 可 以 指定 希望 按 名 称 访问 的 形 参 并 仅 将 实 参 发 送 到 这 些 形 参 。 在 本 
AH E 发 送 实 参 以 指示 应 创建 指向 剪贴 板 上 工作 得 的 链接 UPS Link) 并 指 
示 该 链接 应 在 Word 文档 中 显示 为 图 标 (ZS DisplayAslcon) 。Visual C£ 
2010 还 允许 你 忽略 这 些 参 数 的 ref 关键 字 。 将 Visual C# 2008 的 以 下 代码 自 
与 Visual C# 2010 中 需要 的 单行 进行 比较 : 


// Call to PasteSpecial in Visual C£ 2008. 

object iconIndex - Type.Missing; 

object link - true; 

object placement - Type.Missing; 

object displayAsIcon - true; 

object dataType - Type.Missing; 

object iconFileName - Type.Missing; 

object iconLabel - Type.Missing; 

wordApp.Selection.PasteSpecial(ref iconIndex, 
ref link, 
ref placement, 
ref displayAsIcon, 
ref dataType, 
ref iconFileName, 
ref iconLabel); 


// Call to PasteSpecial in Visual C£ 2010. 
wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true) 


a 


运行 应 用 程序 


1. 按 F5 运行 该 应 用 程序 。 Excel 启动 并 显示 包含 bankAccounts 中 两 个 帐户 的 信 
息 的 表 。 然 后 ， 出 现 包含 指向 Excel RA Word 文档 。 





育 理 已 完成 的 项 目 


1. f£ Visual Studio 中 ， 单 击 “ 生 成 ”菜单 上 的 “清理 解决 方案 ”。 否 则 ， 每 次 在 计算 
机 上 打开 Excel 时 都 会 运行 外 接应 用 程序 。 


查找 PIA 引用 


1. 再 次 运行 应 用 程序 ， 但 不 单 击 “ 清 理解 决 方案 ”。 


2. 在 “开始 "菜单 上 ， 单 击 “ 所 有 程序 ”"。 接 下 来 依次 单 击 “Microsoft Visual Studio 
2013", "Visual Studio TR”, "Visual Studio 命令 提示 符 pus 


3. 在 Visual Studio 命令 提示 符 (2013) 窗口 中 键入 ildasm， 然 后 按 Enter。 此 时 
EH 3, IL DASM 窗口 。 


4. TE IL DASM 窗口 的 “文件 "菜单 上 ， 单 击 “ 打 开 ”。 双 击 “Visual Studio 2013”， 然 
后 双击 “项 目 "。 打 开 项 目的 文件 夹 ， 在 bin/Debug 文件 夹 中 查找 项 目 名 称 .dll。 
双击 项 目 名 称 .dll。 新 窗口 将 显示 项 目的 属性 以 及 对 其 他 模块 和 程序 集 的 引 
用 。 注 意 ， 命 名 空间 Microsoft.Office.Interop.Excel 和 
Microsoft.Office.Interop.Word 包含 在 程序 集中 。 在 Visual Studio 2013 rh, 
编译 器 默认 将 你 需要 的 类 型 从 引用 的 PIA 导入 程序 集 。 


有 关 详 细 信 息 ， 请 参阅 如 何 : 查看 程序 集 内 容 。 


5. 双击 "清单 ?图标 。 此 时 将 出 现 包含 程序 集 列 表 的 窗口 ， 这 些 程序 集 包 含 项 目 所 
引用 的 项 。 Microsoft.Office.Interop.Excel 和 
Microsoft.Office.Interop.Word 未 包含 在 列表 中 。 由 于 项 目 需要 的 类 型 已 导 人 
程序 集中 ， 因 此 不 需要 引用 PIA。 这 使 得 部 署 变 得 更 加 容易 。 用 户 的 计算 机 上 
不 必 存 在 PIA， 因 为 应 用 程序 不 需要 部 署 特定 版 本 的 PIA， 应 用 程序 可 设计 为 
与 多 个 版 本 的 Office 配合 使 用 ， 前 提 是 所 有 版 本 中 都 存在 必要 的 AP|。 


由 于 不 再 需要 部 署 PIA， 你 可 以 提前 创建 可 与 多 个 版 本 的 Office (包括 之 前 的 
版 本 ) 配合 使 用 的 应 用 程序 。 但 是 ， 仅 当 你 的 代码 不 使 用 你 当前 所 使 用 Office 
版 本 中 不 可 用 的 任何 API 时 ， 此 情况 才 适 用 。 特 殊 API 在 早期 版 本 中 是 否 可 用 
并 不 始终 明确 ， 因 此 不 建议 使 用 早期 版 本 的 Office. 


6. 关闭 清单 窗口 和 程序 集 窗 口 。 
8 注意 


在 Office 2003 以 前 ，Office 并 不 发 布 PIA。 因 此 ， 生 成 适用 于 Office 2002 或 
早期 版 本 的 互 操作 程序 集 的 唯一 方法 是 导入 COM 引用 。 


还 原 PIA 依赖 项 
1. 在 “解决 方案 资源 管理 器 "中 ， 单 击 “ 显 示 所 有 文件 "按钮 。 展 开 “ 引 用 ”文件 夹 并 选 
1&"Microsoft.Office.Interop.Excel", 1£ F4 以 显示 “属性 ”窗口 。 

. 在 “属性 "窗口 中 ， 将 “ 苦 入 互 操作 类 型 "属性 从 “True” 更 改 为 “False”。 

， 对 Microsoft.Office.Interop.Word 重复 此 程序 中 的 步骤 1 和 2。 

. 在 Cit rh, f£ DisplayInExcel 方法 的 末尾 注释 掉 对 Autofit 的 两 次 调用 。 

. SR F5 以 验证 项 目 是 否 仍 正确 运行 。 


. 重复 上 一 个 程序 的 步骤 1-3 以 打开 程序 集 窗口 。 注 
意 ，Microsoft.Office.Interop.Word 和 Microsoft.Office.Interop.Excel 不 再 
位 于 艇 和 程序 集 列 表 中 。 


7. 双击 "清单 图标 并 滚动 引用 程序 集 的 列表 。 Microsoft.Office.Interop.Word 和 
Microsoft.Office.Interop.Excel 均 位 于 列表 中 。 由 于 应 用 程序 引用 Excel 和 
Word PIA 并 且 “ 铅 入 互 操作 类 型 "属性 设置 为 “False”， 因 此 最 终 用 户 的 计算 机 上 
必须 存在 两 个 程序 集 。 


8. ft Visual Studio 中 ， 单 击 “ 生 成 "菜单 上 的 “清理 解决 方案 "以 清理 完成 的 项 目 。 


O oc Aà OO N 


请 参阅 


自动 实现 的 属性 (Visual Basic) 


MSDN C# 编程 指南 & 参考 手册 2015 


自动 实现 的 属性 (C# 编程 指南 ) 
集合 初始 值 设 定 项 (Visual Basic) 

对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) 
可 选 参数 (Visual Basic) 

按 位 置 和 名 称 传递 参数 (Visual Basic) 
MAREMARE (CH 编程 指南 ) 
早期 绑 定 和 后 期 绑 定 (Visual Basic) 
dynamic (C# 参考 ) 

使 用 类 型 dynamic (C£ 编程 指南 ) 
Lambda 表达 式 (Visual Basic) 
Lambda 表达 式 (CH 编程 指南 ) 


如 何 : 在 COM 互 操作 编程 中 使 用 索引 属性 (CH 编程 指南 ) 

演练 : HRA Microsoft Office 程序 集中 的 类 型 信息 (C# 和 Visual Basic) 
演练 : RAP SERRA AH (C# 和 Visual Basic) 

演练 : 创建 你 的 第 一 个 Excel VSTO 外 接 程序 


COM 互 操作 (Visual Basic) 
互 操作 性 (CH 编程 指南 ) 


演练 : Office 编程 (C# 和 Visual Basic) 
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COM 类 示例 (CH 编程 指南 ) 


下 面 是 一 个 公开 为 COM 对 象 的 类 的 示例 。 将 这 些 代 码 放置 到 .cs 文件 中 并 添加 到 
您 的 项 目 中 后 ， 请 将 “Register for COM Interop” 属 性 设置 为 “True”。 有 关 更 多 信 
息 ， 请 参见 NIB: How to: Register a Component for COM Interop. 


向 COM 公开 Visual C# 对 象 要 求 声明 一 个 类 接口 、 一 个 事件 接口 《如果 需要 ) 和 
类 本 身 。 类 成 员 必 须 遵循 下 列 规则 才能 对 COM 可 见 : 


e 类 必须 是 公共 的 。 

e 属性 、 方 法 和 事件 必须 是 公共 的 。 
。 属性 和 方法 必须 在 类 接口 上 声明 。 
。 事件 必须 在 事件 接口 中 声明 。 


其 他 没有 在 这 些 接口 中 声明 的 类 的 公共 成 员 对 于 COM 是 不 可 见 的 ， 但 它们 对 于 其 
他 NET Framework 对 象 将 是 可 见 的 。 


若 要 向 COM 公开 属性 和 方法 ， 必 须 在 类 接口 上 声明 这 些 属 性 和 方法 ， 并 用 Displd 
特性 予以 标记 ， 然 后 在 类 中 实现 它们 。 成 员 在 接口 中 声明 的 顺序 即 是 用 于 COM 
vtable 的 顺序 。 


若 要 从 类 中 公开 事件 ， 必 须 在 事件 接口 上 声明 这 些 事件 ， 并 用 Displd 特性 予以 标 
记 。 该 类 不 应 实现 此 接口 。 


类 实现 类 接口 ; 它 可 以 实现 多 个 接口 ， 但 第 一 个 实现 将 作为 默认 类 接口 。 在 此 处 实 
mA COM 公开 的 方法 和 属性 。 它 们 必须 标记 为 是 公共 的 ， 并 且 必 须 和 与 类 接口 中 的 
声明 匹配 。 同 时 ， 在 此 处 声明 由 类 引发 的 事件 。 它 们 必须 标记 为 是 公共 的 ， 并 且 必 
须 与 事件 接口 中 的 声明 匹配 。 


using System.Runtime.InteropServices; 


namespace project name 


t 
[Guid("EAA4976A-45C3-ABC5-BCOB-EA74FACS3C83F") ] 


public interface ComClassiInterface 
{ 
} 


[Guid("7BD20046-DF8C-44A6-8F6B-687FAA26FAT71"), 
InterfaceType(ComInterfaceType.InterfaceIsIDispatch)] 
public interface ComClassiEvents 


{ 
} 


[Guid ("0D53A3E8-E51A-49C7-944E-E72A2064F938"), 
ClassInterface(ClassInterfaceType.None), 
ComSourceInterfaces(typeof(ComClassiEvents))] 

public class ComClassi : ComClassiInterface 


D 


请 参阅 

C# 编程 指南 

互 操作 性 (CH 编程 指南 ) 
“项 目 设计 器 "->“ 生 成 "页 (C#) 


LINQ 查询 表达 式 (CH ate) 


滞 计 集成 查询 (LINQ) 是 是 一 组 技术 的 名 称 ， 这 些 技术 建立 在 将 查询 功能 直接 集成 到 
C# 语言 (以 及 Visual Basic 和 可 能 的 任何 其 他 .NET 语言 ) 的 基础 上 。 借 助 于 
LINQ, 查询 现在 已 是 高 级 语言 构造 ， 就 如 同类 、 方 法 、 事 件 等 等 。 

对 于 编写 查询 的 开发 人 员 来 说 ，LINQ 最 明显 的 "语言 集成 "部 分 是 查询 表达 式 。 查 询 
表达 式 是 使 用 C# 3.0 中 引入 的 声明 性 查询 语法 编写 的 。 通 过 使 用 查询 语法 ， 您 其 
至 可 以 使 用 最 少 的 代码 对 数据 源 执行 复杂 的 筛选 、 排 序 和 分 组 操作 。 您 使 用 相同 的 
基本 查询 表达 式 模式 来 查询 和 转换 SQL 数据 库 、ADO.NET 数据 集 、XML 文档 和 
流 以 及 NET 集合 中 的 数据 。 


下 面 的 示例 演示 了 完整 的 查询 操作 。 完 整 操 作 包括 创建 数据 源 、 定 义 查询 表达 式 ， 
以 及 在 foreach 话 句 中 执行 查询 。 
class LINQQueryExpressions 


static void Main() 


{ 


// Specify the data source. 
int[] scores = new int[] { 97, 92, 81, 60 }; 
// Define the query expression. 
IEnumerable<int> scoreQuery = 

from score in scores 

where score > 80 

select score; 


// Execute the query. 
foreach (int i in scoreQuery) 


Console.Write(i +" "); 


j 


} 
// Output: 97 92 81 


有 关 C# 中 的 LINQ 基础 知识 的 更 多 信息 ， 请 参见 Getting Started with LINQ in 
Ch; 


查询 表达 式 概述 


e 查询 表达 式 可 用 于 查询 和 转换 来 自任 意 支持 LINQ 的 数据 源 中 的 数据 。 例 如 ， 
单个 查询 可 以 从 SQL 数据 库 检 索 数 据 ， 并 生成 XML 流 作为 输出 。 


查询 表达 式 容易 掌握 ， 因 为 它们 使 用 许多 常见 的 C# 语言 构造 。 有 关 更 多 信 
息 ， 请 参见 Getting Started with LINQ in CZ, 


查询 表达 式 中 的 变量 都 是 强 类 型 的 ， 但 许多 情况 下 您 不 需要 显 式 提 供 类 型 ， 因 
为 编译 器 可 以 推断 类 型 。 有 关 更 多 信息 ， 请 参见 Type Relationships in LINQ 
Query Operations (CZ). 


在 您 循环 访问 foreach 语句 中 的 查询 变量 之 前 ， 不 会 执行 查询 。 有 关 更 多 信 
息 ， 请 参见 Introduction to LINQ Queries (C£), 


在 编译 时 ， 根 据 CH 规范 中 设置 的 规则 将 查询 表达 式 转 换 为 “标准 查询 运算 

符 ” 方 法 调用 。 任 何 可 以 使 用 查询 语法 表示 的 查询 也 可 以 使 用 方法 语法 表示 。 但 
是 ， 在 大 多 数 情 况 下 ， 查 询 语法 更 易 读 和 简洁 。 有 关 更 多 信息 ， 请 人 参见 CH 语 
言 规范 和 Standard Query Operators Overview. 


作为 编写 LINQ 查询 的 一 项 规则 ， 建 议 尽 量 使 用 查询 语法 ， 只 在 必需 的 情况 下 
才 使 用 方法 语法 。 这 两 种 不 同形 式 在 语义 或 性 能 上 没有 区 别 。 查 询 表 达 式 通常 
比 用 方法 语法 编写 的 等 效 表达 式 更 易 读 。 

e 一 些 查询 操作 ， 如 Count<TSource> 或 Max， 没 有 等 效 的 查询 表达 式 子 句 ， 


此 必须 表示 为 方法 调用 。 方 法 语法 可 以 通过 多 种 方式 与 查询 语法 组 合 。 有 关 更 
多 信息 ， 请 参见 Query Syntax and Method Syntax in LINQ (C#)。 

查询 表达 式 可 以 编译 为 表达 式 树 或 委托 ， 具 体 取决 于 查询 所 应 用 到 的 类 型 。 
IEnumerable<T> 查询 编译 为 委托 。 IQueryable 和 IQueryable<T> 查询 编译 为 
表达 式 树 。 有 关 更 多 信息 ， 请 参见 表达 式 树 (C# 和 Visual Basic) 。 


下 表 列 出 了 一 些 主题 ， 提 供 有 关 常 规 任务 的 查询 和 代码 示例 的 其 他 信息 。 


主题 
查询 表达 式 基础 (CH 编程 指南 ) 


如 何 : 在 CH 中 编写 LINQ 查询 


如 何 : 在 查询 表达 式 中 人 处理 异常 
(C# 编程 指南 ) 


How to: Populate Object 
Collections from Multiple 
Sources (LINQ) 


如 何 : 对 查询 结果 进行 分 组 (CH 
编程 指南 ) 

如 何 : ej ER (CH 编程 指 
南 ) 


如 何 : 对 分 组 操作 执行 子 查询 
(CH 编程 指南 ) 


说 明 


介绍 基本 查询 概念 并 提供 CH 查询 语法 的 
示例 。 


提供 若干 基本 查询 表达 式 类 型 的 示例 。 
如 何以 及 何 时 将 可 能 会 引发 异常 的 代码 移 
出 查询 表达 式 。 


如 何 使 用 select 语句 将 来 自 不 同 源 的 数据 
合并 为 新 类 型 。 


演示 使 用 group 子 句 的 不 同方 法 。 
演示 如 何 创 建 戏 套 组 。 
演示 如 何 使 用 查询 中 的 子 表达 式 作 为 新 查 


询 的 数据 源 。 
演示 如 何 实现 线程 安全 的 标准 查询 运算 


MSDN CZ 编程 指南 & 参考 手册 2015 
(C# 编程 指南 ) 
如 何 : 在 运行 时 动态 指定 谓词 算 


选 器 (C# 编程 指南 ) 


如 何 : 在 内 存 中 存储 查询 结果 
(C# 编程 指南 ) 


如 何 : 从 方法 中 返回 查询 (CH 编 
程 指 南 ) 


如 何 : 执行 自 定义 联接 操作 (CH 
编程 指南 ) 


如 何 : 使 用 复合 键 进行 联接 (CH 
编程 指南 ) 


如 何 : 对 Join 子 句 的 结果 进行 排 
Fe (C# 编程 指南 ) 


如 何 : 执行 内 部 联接 (CH 编程 指 
南 ) 


d : 执行 分 组 联接 (CH 编程 指 


如 何 : 执行 左 外 部 联接 (CH 编程 


指南 ) 


如 何 : 在 查询 表达 式 中 义理 Null 
值 (CH 编程 指南 ) 


请 参阅 
C# 编程 指南 
LINQ (Language-Integrated Query) 


符 ， 该 运算 符 可 对 流 式 数据 源 执行 分 组 操 
作 。 


演示 如 何 为 where 子 句 的 相等 比较 提供 任 
意 数目 的 值 。 


阐释 如 何 有 具体 化 和 存储 查询 结果 ， 而 不 必 
使 用 foreach 循环 。 


演示 如 何 从 方法 返回 查询 变量 ， 以 及 如 何 
将 它们 作为 输入 参数 传递 给 方法 。 


演示 如 何 基于 任何 类 型 的 谓词 本 数 执行 联 
接 运算 。 


演示 如 何 基于 多 个 匹配 键 联接 两 个 源 。 


演示 如 何 对 联接 运算 生成 的 序列 进行 排 


it 


演示 如 何在 LINQ 中 执行 内 联 。 


演示 如 何在 LINQ 中 生成 已 分 组 的 联接 。 


演示 如 何在 LINQ 中 生成 左 外 部 联接 。 


演示 如 何在 LINQ 查询 中 处 理 null 值 。 


Walkthrough: Writing Queries in C# (LINQ) 


Basic LINQ Query Operations (C#) 


Query Syntax and Method Syntax in LINQ (C#) 


Standard Query Operators Overview 


查询 关键 字 〈C# 参考 ) 


How Linq to Objects Queries Work (Linq to Objects 查询 如 何 工 作 ) 


Reading and Writing Queries ( 读 取 和 编写 查询 ) 


LINQ 查询 表达 式 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


What is a collection? (什么 是 集合 ? ) 


Link to Everything: A List of LINQ Providers (所 有 链接 : LINQ 提供 程序 列表 ) 


LINQ 查询 表达 式 (CH 编程 指南 ) 338 


查询 表达 式 基 础 (C# 编程 指南 ) 


什么 是 查询 ? 它 有 什么 用 途 ? 


“查询 "是 指 一 组 指令 ， 这 些 指令 描述 要 从 一 个 或 多 个 给 定数 据 源 检 索 的 数据 以 及 返 
回 的 数据 应 该 使 用 的 格式 和 组 织 形 式 。 查 询 不 同 于 它 所 产生 的 结果 。 


通常 ， 源 数据 会 在 逻辑 上 组 织 为 相同 种 类 的 元 素 序 列 。SQL 数据 库 表 包含 一 个 行 序 
列 。 与 此 类 似 ，ADO.NET DataTable 包含 一 个 DataRow 对 象 序列 。 在 XML 文件 
中 ， 有 一 个 XML 元素“ 序列”( 不 过 这 些 元 素 按 分 层 形 式 组 织 为 树 结构 ) 。 内 存 中 的 
集合 包含 一 个 对 象 序列 。 


从 应 用 程序 的 角度 来 看 ， 原 始 源 数据 的 具体 类 型 和 结构 并 不 重要 。 应 用 程序 始终 将 
源 数 据 视 为 一 个 IEnumerable<T> 或 IQueryable«T» 集合 。 在 LINQ to XML rh, 
源 数 据 显 示 为 一 个 IEnumerable<XElement>。 在 LINQ to DataSet 中 ， 它 是 一 个 
IEnumerable<DataRow>。 在 LINQ to SQL 中 ， 它 是 您 定义 用 来 表示 SQL 表 中 数 
据 的 任何 自 定义 对 象 的 IEnumerable 或 IQueryable。 


指定 此 源 序列 后 ， 查 询 可 以 进行 下 列 三 项 工作 之 一 : 


e 检索 一 个 元 素 子 集 以 产生 一 个 新 序列 ， 但 不 修改 单个 元 素 。 然 后 ， 查 询 可 以 按 
各 种 方式 对 返回 的 序列 进行 排序 或 分 组 ， 如 下 面 的 示例 所 示 (假定 scores 是 
int[]) 


IEnumerable&lt;int&gt; highScoresQuery - 
from score in scores 
where score &gt; 80 
orderby score descending 
select score; 


如 上 一 个 示例 所 述 检索 一 个 元 素 序 列 ， 但 是 将 这 些 元 素 转 换 为 具有 新 类 型 的 对 
象 。 例 如 ， 查 询 可 以 只 从 数据 源 中 的 某 些 客户 记录 检索 姓氏 。 或 者 ， 查 询 可 以 
检索 完整 的 记录 ， 再 使 用 它 构建 另 一 个 内 存 中 对 象 类 型 甚至 XML 数据 ， 然 后 
生成 最 终 的 结果 序列 。 下 面 的 示例 演示 了 从 int 到 string 的 转换 。 请 注意 
highScoresQuery 的 新 类 型 。 


IEnumerable&lt;string&gt; highScoresQuery2 = 
from score in scores 
where score &gt; 80 
orderby score descending 
select String.Format("The score is (0)", score); 


检索 有 关 源 数据 的 单一 值 ， 例 如 : 
o 符合 某 个 条 件 的 元 素 的 数量 。 


o 具有 最 大 值 或 最 小 值 的 元 素 。 


o 符合 某 个 条 件 的 第 一 个 元 素 ， 或 一 组 指定 元 素 中 的 特定 值 之 和 。 例 如 ， 下 
面 的 查询 从 scores 整数 数组 中 返回 高 于 80 的 分 数 的 数量 。 


int highScoreCount = 
(from score in scores 
where score &gt; 80 
select score) 
-Count(); 


在 上 一 个 示例 中 ， 请 注意 在 Count 方法 调用 之 前 的 查询 表达 式 两 旁 使 用 了 括 
号 。 另 一 种 表示 方式 是 使 用 一 个 新 变量 来 存储 具体 结果 。 此 技术 的 可 读 性 更 
好 ， 因 为 它 将 存储 查询 的 变量 与 存储 结果 的 查询 区 分 开 来 。 


IEnumerable&lt;int&gt; highScoresQuery3 = 
from score in scores 
where score &gt; 80 
select score; 


int scoreCount - highScoresQuery3.Count(); 


在 上 一 个 示例 中 ， 查 询 是 在 Count 调用 中 执行 的 ， 因 为 Count 必须 循环 访问 结果 
以 便 确 定 highScoresQuery 返回 的 元 素数 量 。 


什么 是 查询 表达 式 ? 


“查询 表达 式 " 是 用 查询 语法 表示 的 查询 ， 是 一 流 的 语言 构造 。 它 就 像 任何 其 他 表达 
式 一 样 ， 并 且 可 以 用 在 CHE 表达 式 有 效 的 任何 上 下 文中 。 查 询 表达 式 由 一 组 用 类 似 
于 SQL 或 XQuery 的 声明 性 语法 编写 的 子 句 组 成 。 每 个 子 句 又 包含 一 个 或 多 个 CH 
表达 式 ， 而 这 些 表 达 式 本 身 又 可 能 是 查询 表达 式 或 包含 查询 表达 式 。 


查询 表达 式 必须 以 from 子 句 开头 ， 并 且 必 须 以 select 或 group 子 句 结尾 。 在 第 一 
个 from 子 句 和 最 后 一 个 select 或 group 子 句 之 间 ， 查 询 表 达 式 可 以 包含 一 个 或 
多 个 下 列 可 选 子 句 : where、orderby、join、let 甚至 附加 的 from 子 句 。 还 可 以 使 
用 into 关键 字 使 join 或 group 子 句 的 结果 能 够 充当 同一 查询 表达 式 中 附加 查询 子 
句 的 源 。 


查询 变量 


在 LINQ 中 ， 查 询 变量 是 任何 存储 查询 (而 非 查 询 结 果 ) HES BRAM, A 
询 变量 始终 是 一 个 可 榴 举 的 类 型 ， 当 在 foreach 语句 中 或 在 对 其 
IEnumerator.MoveNext 方法 的 直接 调用 中 循环 访问 它 时 ， 它 会 生成 一 序列 元 素 。 


下 面 的 代码 示例 演示 了 一 个 简单 的 查询 表达 式 ， 它 含有 一 个 数据 源 、 一 个 筛选 子 名 
和 一 个 排序 子 句 ， 但 不 对 源 元 素 进 行 转换 。 select 子 句 结束 了 该 查询 。 


static void Main() 
{ 
// Data source. 
int[] scores = { 90, 71, 82, 93, 75, 82 }; 


// Query Expression. 
IEnumerable<int> scoreQuery = //query variable 
from score in scores //required 
where score » 80 // optional 
orderby score descending // optional 
select score; //must end with select or group 


// Execute the query to produce the results 
foreach (int testScore in scoreQuery) 


Console.WriteLine(testScore); 


j 


j 
// Outputs: 93 90 82 82 


在 上 一 个 示例 中 ，scoreQuery 是 一 个 查询 变量 ， 有 时 简称 为 “查询 "。 查 询 变 量 并 不 
存储 实际 的 结果 数据 (这 些 数据 是 在 foreach 循环 中 产生 的 ) 。 另 外 ， 当 foreach 
语句 执行 时 ， 查 询 结 果 并 不 是 通过 查询 变量 scoreQuery 返回 的 。 相 反 ， 它 们 是 通 

AL X B testScore 返回 的 。 可 以 在 另 一 个 foreach 循环 中 迭代 scoreQuery ¥ 

量 。 只 要 该 变量 和 数据 源 都 没有 修改 ， 该 变量 都 季 产 生 相 同 的 结果 。 


查询 变量 可 以 存储 用 查询 语法 或 方法 语法 (或 二 者 的 组 合 ) 表示 的 查询 。 在 下 面 的 
示例 中 ，queryMajorCities 和 queryMajorCities2 都 是 查询 变量 : 


//Query syntax 

IEnumerable«City» queryMajorCities = 
from city in cities 
where city.Population » 100000 
select city; 


// Method-based syntax 
IEnumerable«City» queryMajorCities2 = cities.Where(c => c.Populatic 





另 一 方面 ， 下 面 的 两 个 示例 演示 了 不 是 查询 变量 的 变量 ， 即 使 每 个 变量 都 用 查询 进 
行 了 初始 化 。 它 们 不 是 查询 变量 的 原因 是 它们 存储 了 结果 : 


int highestScore - 
(from score in scores 
select score) 
.Max(); 


// or split the expression 
TEnumerable<int> scoreQuery = 
from score in scores 

select score; 


int highScore = scoreQuery.Max(); 


List<City> largeCitiesList = 
(from country in countries 
from city in country.Cities 
where city.Population > 10000 
select city) 
.ToList(); 


// or split the expression 
IEnumerable<City> largeCitiesQuery = 
from country in countries 
from city in country.Cities 
where city.Population > 10000 
select city; 


List<City> largeCitiesList2 = largeCitiesQuery.ToList(); 


Mox 
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在 LINQ 文档 中 ， 存 储 查 询 的 变量 在 其 名 称 中 包含 单词 “query”， 而 存储 实际 结 
果 的 变量 在 其 名 称 中 不 包含 单词 “query”。 


有 关 用 于 表示 查询 的 不 同方 式 的 更 多 信息 ， 请 参见 Query Syntax and Method 
Syntax in LINQ (C£), 


查询 变量 的 显 式 类 型 化 和 隐 式 类 型 化 


本 文档 通常 提供 查询 变量 的 显 式 类 型 ， 以 便 演示 查询 变量 和 select 子 句 之 间 的 类 型 
关系 。 但 是 ， 也 可 以 使 用 var 关键 字 指 示 编 译 器 在 编译 时 推断 查询 变量 (或 任何 其 
他 本 地 变量 ) 的 类 型 。 例 如 ， 还 可 以 使 用 隐 式 类 型 化 表示 本 主题 前 面部 分 中 演示 的 
查询 示例 : 


// Use of var is optional here and in all queries. 
// queryCities is an IEnumerable<City> just as 
// when it is explicitly typed. 
var queryCities - 
from city in cities 
where city.Population » 100000 
select city; 


有 关 更 多 信息 ， 请 参见 隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) 和 Type Relationships 
in LINQ Query Operations (C£), 


开始 查询 表达 式 


查询 表达 式 必须 以 from 子 句 开头 。 它 同时 指定 了 数据 源 和 范围 变量 。 在 对 源 序列 
进行 静 历 的 过 程 中 ， 范 围 变量 表示 源 序 列 中 的 每 个 后 续 元 素 。 将 根据 数据 源 中 元 素 
的 类 型 对 范围 变量 进行 强 类 型 化 。 在 下 面 的 示例 中 ， 因 为 countries 是 Country 对 

象 数 组 ， 所 以 范围 变量 也 被 类 型 化 为 Country， 这 样 就 可 以 使 用 点 运算 符 来 访问 该 

类 型 的 任何 可 用 成 员 。 


IEnumerable«Country» countryAreaQuery = 
from country in countries 
where country.Area » 500000 //sq km 
select country; 


在 使 用 分 号 或 延续 子 句 退出 查询 之 前 ， 范 围 变量 将 一 直 位 于 范围 中 。 


查询 表达 式 可 以 包含 多 个 from 子 句 。 当 源 序 列 中 的 每 个 元 素 本 身 就 是 集合 或 包含 
集合 时 ， 可 使 用 附加 的 from 子 句 。 例 如 ， 假 定 您 具有 一 个 Country 对 象 集合 ， 而 
其 中 每 个 对 象 都 包含 一 个 名 为 Cites 的 City 对 象 集合 。 若 要 查询 每 个 Country 中 的 
City 对 象 ， 请 使 用 两 个 from 子 句 ， 如 下 所 示 : 


IEnumerable«City» cityQuery = 
from country in countries 
from city in country.Cities 
where city.Population » 10000 
select city; 


有 关 更 多 信息 ， 请 参见 from 子 句 (C£ X), 


结束 查询 表达 式 
查询 表达 式 必须 以 select 子 句 或 group 子 句 结尾 。 


group 子 句 


使 用 group 子 句 可 产生 按照 指定 的 键 组 织 的 组 序列 。 键 可 以 采用 任何 数据 类 型 。 例 
如 ， 下 面 的 查询 创建 一 个 组 序列 ， 该 序列 包含 一 个 或 多 个 Country 对 象 ， 并 且 它 的 
键 是 char 值 。 


var queryCountryGroups = 
from country in countries 
group country by country.Name[0]; 


有 关 分 组 的 更 多 信息 ， 请 参见 group fH (CH 2X), 


select 子 句 


使 用 select 子 句 可 产生 所 有 其 他 类 型 的 序列 。 简 单 的 select 子 句 只 是 产生 与 数据 
源 中 包含 的 对 象 具 有 相同 类 型 的 对 象 的 序列 。 在 此 示例 中 ， 数 据 源 包 含 Country 对 
象 。 orderby 子 句 只 是 将 元 素 重新 排序 ， 而 select 子 句 则 产生 重新 排序 的 
Country 对 象 的 序列 。 


IEnumerable«Country» sortedQuery = 
from country in countries 
orderby country.Area 
select country; 


可 以 使 用 select 子 句 将 源 数据 转换 为 新 类 型 的 序列 。 这 一 转换 也 称 为 “投影 "。 在 下 
面 的 示例 中 ，select 子 句 对 一 个 匿名 类 型 序列 进行 投影 ， 该 序列 仅 包含 原始 元 素 中 
各 字段 的 子 集 。 请 注意 ， 新 对 象 是 使 用 对 象 初始 值 设 定 项 初始 化 的 。 


// Here var is required because the query 
// produces an anonymous type. 
var queryNameAndPop - 
from country in countries 
select new { Name = country.Name, Pop = country.Population }; 


EE) 
有 关 使 用 select 子 句 转换 源 数据 的 所 有 方式 的 更 多 信息 ， 请 参见 select +) (CH 


参考 ) 。 


使 用 “into” 进 行 延续 


可 以 在 select 或 group FA HEH into 关键 字 来 创建 用 于 存储 查询 的 临时 标识 
符 。 当 您 必须 在 分 组 或 选择 操作 之 后 对 查询 执行 附加 查询 操作 时 ， 需 要 这 样 做 。 在 
下 面 的 示例 中 ， 以 一 千 万 人 口 范 围 为 界 对 countries 进行 分 组 。 在 创建 这 些 组 之 
后 ， 使 用 附加 子 句 筛选 掉 某 些 组 ， 然 后 按 升序 对 剩 下 的 组 进行 排序 。 若 要 执行 这 些 
附加 操作 ， 需 要 使 用 由 countryGroup 表示 的 延续 。 


// percentileQuery is an IEnumerable<IGrouping<int, Country>> 
var percentileQuery - 

from country in countries 

let percentile - (int) country.Population / 10000000 

group country by percentile into countryGroup 

where countryGroup.Key »- 20 

orderby countryGroup.Key 

select countryGroup; 


// grouping is an IGrouping<int, Country» 
foreach (var grouping in percentileQuery) 


Console.WriteLine(grouping.Key); 
foreach (var country in grouping) 
Console.WriteLine(country.Name + ":" + country.Population), 





筛选 、 排 序 和 联接 


在 from 开始 子 句 以 及 select 或 group 结束 子 句 之 间 ， 所 有 其 他 子 句 
(where, join, orderby, from, let) 都 是 可 选 的 。 任 何 可 选 子 句 都 可 以 在 查询 
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where +4) 


使 用 where 子 句 可 以 根据 一 个 或 多 个 谓词 表达 式 筛选 掉 源 数据 中 的 某 些 元 素 。 以 
下 示例 中 的 where 子 句 含有 两 个 谓词 。 


IEnumerable<City> queryCityPop = 
from city in cities 
where city.Population < 200000 && city.Population > 100000 
select city; 


有 关 更 多 信息 ， 请 参见 where + (CE 2X) 。 


orderby 子 句 


使 用 orderby 子 句 可 以 按 升 序 或 降序 对 结果 进行 排序 。 您 还 可 以 指定 次 要 排序 顺 
序 。 下 面 的 示例 使 用 Area 属性 对 country 对 象 执 行 主要 排序 ， 然 后 使 用 
Population 属性 执行 次 要 排序 。 


IEnumerable«Country» querySortedCountries - 
from country in countries 
orderby country.Area, country.Population descending 
select country; 


ascending 关键 字 是 可 选 的 ; 如 果 未 指定 顺序 ， 则 它 是 默认 排序 顺序 。 有 关 更 多 1 
息 ， 请 参见 orderby 子 句 (CH 参考 ) 。 


Dili 


join +4) 


使 用 join 子 句 可 以 根据 每 个 元 素 中 指定 键 之 间 的 相等 比较 ， 对 一 个 数据 源 中 的 元 素 
与 另外 一 个 数据 源 中 的 元 素 进 行 关 联 和 /或 组 合 。 在 LINQ 中 ， 联 接 操作 是 针对 其 元 
素 具 有 不 同类 型 的 对 象 序列 执行 的 。 在 联接 两 个 序列 之 后 ， 必 须 使 用 select 或 
group 语句 指定 要 存储 到 输出 序列 中 的 元 素 。 还 可 以 使 用 匿名 类 型 将 每 组 关联 元 素 
中 的 属性 组 合 为 输出 序列 的 新 类 型 。 下 面 的 示例 对 其 Category 属性 与 categories 
字符 串 数组 中 的 某 个 类 别 相 匹 配 的 prod 对 象 进 行 关联 。 其 Category 不 与 
categories 中 的 任何 字符 串 匹 配 的 产品 会 被 筛选 掉 。 select 语句 投影 了 一 个 新 类 
型 ， 其 属性 取 自 cat 和 prod。 


var categoryQuery = 
from cat in categories 
join prod in products on cat equals prod.Category 
select new { Category = cat, Name = prod.Name }; 


通过 使 用 into 关键 字 将 join 操作 的 结果 存储 到 临时 变量 中 ， 还 可 以 执行 分 组 联 
接 。 有 关 更 多 信息 ， 请 参见 join FH (Cf), 


let 子 名 


使 用 let 子 句 可 以 将 表达 式 (如 方法 调用 ) 的 结果 存储 到 新 的 范围 变量 中 。 在 下 面 
的 示例 中 ， 范 围 变 量 firstName 存储 了 Split 返回 的 字符 串 数 组 的 第 一 个 元 素 。 


string[] names = ( "Svetlana Omelchenko", "Claire O'Donnell", "Sver 
IEnumerable«string» queryFirstNames = 

from name in names 

let firstName = name.Split(new char[] { ' ' })[0] 

select firstName; 


foreach (string s in queryFirstNames) 


Console.Write(s + " "); 
//Output: Svetlana Claire Sven Cesar 
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有 关 更 多 信息 ， 请 参见 let 子 句 (C? 2X), 








查询 表达 式 中 的 子 查询 


查询 子 句 本 身 可 能 包含 一 个 查询 表达 式 ， 该 查询 表达 式 有 时 称 为 “ 子 查询 ”"。 每 个 子 
查询 都 以 它 自己 的 from 子 句 开头 ， 该 子 句 不 一 定 指向 第 一 个 from 子 句 中 的 同一 
数据 源 。 例 如 ， 下 面 的 查询 演示 了 一 个 在 select 语句 中 使 用 的 查询 表达 式 ， 用 来 检 
索 分 组 操作 的 结果 。 


var queryGroupMax = 
from student in students 
group student by student.GradeLevel into studentGroup 
select new 


1 
Level - studentGroup.Key, 
HighestScore - 
(from student2 in studentGroup 
select student2.Scores.Average( )) 
.Max() 
3 


有 关 更 多 信息 ， 请 参见 如 何 : 对 分 组 操作 执行 子 查询 (CH 编程 指南 ) 。 


请 参阅 

CH 编程 指南 

LINQ 查询 表达 式 (CH 编程 指南 ) 
LINQ (Language-Integrated Query) 
查询 关键 字 (CH SF) 


Standard Query Operators Overview 


如 何 : 在 CH 中 编写 LING 查询 


本 主题 演示 在 C# 中 编写 LINQ 查询 的 三 种 方式 : 

1. 使 用 查询 语法 。 

2. 使 用 方法 语法 。 

3. 组 合 使 用 查询 语法 和 方法 语法 。 

下 面 的 示例 使 用 前 面 列 出 的 每 种 方式 演示 一 些 简单 的 LINQ 查询 。 一 般 的 规则 是 尽 
可 能 使 用 (1)， 而 在 必要 时 使 用 (2) 和 (3). 

区 注意 


这 些 查 询 作 用 于 简单 的 内 存 中 集合 ; 但 是 ， 基 本 语法 与 LINQ to SQL 和 LINQ 
to XML 中 使 用 的 语法 相同 。 


查询 语法 


编写 大 多 数 查询 的 推荐 方式 是 使 用 查询 语法 来 创建 查询 表达 式 。 下 面 的 示例 演示 了 
三 个 查询 表达 式 。 第 一 个 查询 表达 式 演示 如 何 通 过 用 where 子 句 应 用 条 件 来 筛选 
或 限制 结果 ， 它 返回 源 序列 中 值 大 于 7 或 小 于 3 的 所 有 元 素 。 第 二 个 表达 式 演示 如 
何 对 返回 的 结果 进行 排序 。 第 三 个 表达 式 演示 如 何 按照 键 对 结果 进行 分 组 ， 此 查询 
可 根据 单词 的 第 一 个 字母 返回 两 个 组 。 


// Query #1. 
List<int> numbers = new List<int>() { 5, 4, 1, 3, 9, 8, 6, 7, 2, 0 


// The query variable can also be implicitly typed by using var 
IEnumerable«cint» filteringQuery = 

from num in numbers 

where num < 3 || num > 7 

select num; 


// Query #2. 

TEnumerable<int> orderingQuery = 
from num in numbers 
where num < 3 || num > 7 
orderby num ascending 
select num; 


// Query #8. 
string[] groupingQuery - ( "carrots", "cabbage", "broccoli", "bean: 
IEnumerable«IGrouping«char, string»» queryFoodGroups = 

from item in groupingQuery 

group item by item[0]; 


EE 





PES 


请 注意 ， 这 些 查询 的 类 型 是 IEnumerable<T>。 所 有 这 些 查 询 都 可 以 使 用 var 编 
写 ， 如 下 面 的 示例 所 示 : 


var query = from num in numbers... 


在 上 述 每 个 示例 中 ， 直 到 您 在 foreach 语句 中 循环 访问 查询 变量 时 ， 查 询 才 会 实际 
执行 。 有 关 更 多 信息 ， 请 参见 Introduction to LINQ Queries (C£), 


方法 语法 


某 些 查 询 操 作 必 须 表示 为 方法 调用 。 最 常见 的 此 类 方法 是 那些 返回 单一 数值 的 方 
法 ， 如 Sum, Max. Min, Average 等 。 这 些 方法 在 任何 查询 中 都 必须 总 是 最 后 调 
用 ， 因 为 它们 仅 表 示 单 个 值 ， 不 能 充当 其 他 查询 操作 的 数据 源 。 下 面 的 示例 演示 查 
询 表 达 式 中 的 方法 调用 : 


List<int> numbers1 
List<int> numbers2 
// Query #4. 

double average = numbers1.Average(); 


new List<int>() { 5, 4, 1, 3, 9, 8, 6, 7, 2, í 
new List<int>() { 15, 14, 11, 13, 19, 18, 16, 


// Query #5. 
IEnumerable<int> concatenationQuery = numbers1.Concat(numbers2); 


J — & 
如 果 该 方法 具有 参数 ， 则 这 些 参 数 以 lambda 表达 式 的 形式 提供 ， 如 下 面 的 示例 所 
ZN: 








// Query £6. 
TEnumerable<int> largeNumbersQuery = numbers2.Where(c => c > 15); 


«| cu »| 








在 上 述 查 询 中 ， 只 有 查询 4 立即 执行 。 这 是 因为 它 返 回 单个 值 ， 而 不 是 一 个 泛 型 
IEnumerable<T> 集合 。 方 法 本 身 必须 使 用 foreach 才能 计算 它 的 值 。 


上 述 每 个 查询 都 可 以 通过 结合 使 用 隐 式 类 型 化 与 var 进行 编写 ， 如 下 面 的 示例 所 


小 : 


// var is used for convenience in these queries 

var average - numbersi.Average(); 

var concatenationQuery - numbersi.Concat(numbers2); 
var largeNumbersQuery = numbers2.Where(c => c > 15); 


混合 的 查询 和 方法 语法 


此 示例 演示 如 何 对 查询 子 句 的 结果 使 用 方法 语法 。 只 需 将 查询 表达 式 括 在 括号 内 ， 
然后 应 用 点 运算 符 并 调用 此 方法 。 在 下 面 的 示例 中 ， 查 询 7 返回 其 值 在 3 和 7 之 间 
的 数字 个 数 。 但 是 ， 通 常 更 好 的 做 法 是 使 用 另 一 个 变量 来 存储 方法 调用 的 结果 。 这 
样 就 不 太 容易 将 查询 本 身 与 查询 结果 相 混 淆 。 


// Query #7. 


// Using a query expression with method syntax 
int numCounti = 

(from num in numbersi 

where num « 3 || num » 7 

select num).Count(); 


// Better: Create a new variable to store 
// the method call result 
IEnumerable«int» numbersQuery = 

from num in numbersi 

where num < 3 || num > 7 

select num; 


int numCount2 - numbersQuery.Count(); 


由 于 查询 7 返回 单个 值 而 不 是 一 个 集合 ， 因 此 该 查询 立即 执行 。 
上 述 查 询 可 以 通过 结合 使 用 隐 式 类 型 化 与 var 进行 编写 ， 如 下 所 示 : 


var numCount = (from num in numbers... 


它 可 以 按 如 下 方式 使 用 方法 语法 进行 编写 : 


var numCount = numbers.Where(n => n < 3 || n > 7).Count(); 


它 可 以 按 如 下 方式 使 用 显 式 类 型 化 进行 编写 : 


int numCount = numbers.Where(n => n« 3 || n > 7).Count(); 


请 参阅 

LINQ (Language-Integrated Query) 
Walkthrough: Writing Queries in C£ (LINQ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 

where £4] (CH 参考 ) 


如 何 : 查询 对 象 集合 (CH 编程 指南 ) 


此 示例 演示 如 何 对 一 个 Student 对 象 列表 执行 简单 查询 。 每 个 Student 对 象 都 包含 
一 些 有 关 该 学 生 的 基本 信息 ， 以 及 一 个 表示 该 学 生 的 四 次 考试 得 分 的 列表 。 


此 应 用 程序 充当 此 部 分 中 其 他 很 多 示例 的 框 娘 ， 这 些 示例 都 使 用 相同 的 students 数 


据 源 。 


下 面 的 查询 返回 那些 在 其 第 一 次 考试 中 得 分 为 90 分 或 更 高 的 学 生 。 


public class StudentClass 


( 


#region 


data 


protected enum GradeLevel { FirstYear = 1, SecondYear, ThirdYe: 
protected class Student 


public string FirstName { get; set; } 
public string LastName { get; set; } 
public int ID { get; set; } 

public GradeLevel Year; 

public List<int> ExamScores; 


} 


protected static List<Student> students = new List<Student> 


{ 


new 


new 


new 


new 


new 


new 


new 


new 


Student {FirstName = "Terry", LastName = "Adams", ID = 
Year = GradeLevel.SecondYear, 

ExamScores = new List<int>{ 99, 82, 81, 79}}, 

Student {FirstName = "Fadi", LastName = "Fakhouri", ID 
Year = GradeLevel.ThirdYear, 

ExamScores = new List<int>{ 99, 86, 90, 94}}, 

Student {FirstName = "Hanying", LastName = "Feng", ID: 
Year = GradeLevel.FirstYear, 

ExamScores = new List<int>{ 93, 92, 80, 87}}, 

Student {FirstName = "Cesar", LastName = "Garcia", ID : 
Year = GradeLevel.FourthYear, 

ExamScores = new List<int>{ 97, 89, 85, 82}}, 

Student {FirstName = "Debra", LastName = "Garcia", ID : 
Year = GradeLevel.ThirdYear, 

ExamScores = new List<int>{ 35, 72, 91, 70}}, 

Student {FirstName = "Hugo", LastName = "Garcia", ID = 
Year = GradeLevel.SecondYear, 

ExamScores = new List<int>{ 92, 90, 83, 78}}, 

Student {FirstName = "Sven", LastName = "Mortensen", II 
Year = GradeLevel.FirstYear, 

ExamScores = new List<int>{ 88, 94, 65, 91}}, 

Student {FirstName = "Claire", LastName = "O'Donnell", 
Year = GradeLevel.FourthYear, 

ExamScores = new List<int>{ 75, 84, 91, 39}}, 


new Student {FirstName = "Svetlana", LastName = "Omelchenk: 
Year - GradeLevel.SecondYear, 
ExamScores = new List<int>{ 97, 92, 81, 60}}, 

new Student {FirstName = "Lance", LastName = "Tucker", ID = 
Year = GradeLevel.ThirdYear, 
ExamScores = new List<int>{ 68, 79, 88, 92}}, 

new Student {FirstName = "Michael", LastName = "Tucker", II 
Year = GradeLevel.FirstYear, 
ExamScores = new List<int>{ 94, 92, 91, 91}}, 

new Student {FirstName = "Eugene", LastName = "Zabokritski' 
Year = GradeLevel.FourthYear, 
ExamScores = new List<int>{ 96, 85, 91, 60}} 

J; 


#endregion 


//Helper method, used in GroupByRange. 
protected static int GetPercentile(Student s) 


{ 
double avg = s.ExamScores.Average(); 
return avg > © ? (int)avg / 10 : 0; 
} 
public void QueryHighScores(int exam, int score) 
{ 
var highScores = from student in students 
where student.ExamScores[exam] > score 
select new {Name = student.FirstName, Sco! 
foreach (var item in highScores) 
{ 
Console.WriteLine("{0,-15}{1}", item.Name, item.Score), 
} 
} 
} 
public class Program 
{ 
public static void Main() 
{ 
StudentClass sc = new StudentClass(); 
sc.QueryHighScores(1, 90); 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit"); 
Console.ReadKey(); 
} 
} 





我 们 特意 将 此 查询 编写 得 非常 简单 ， 以 使 您 能 够 进行 试验 。 例 如 ， 您 可 以 在 where 
子 句 中 党 试 使 用 更 多 的 谓词 ， 也 可 以 使 用 orderby 子 句 对 结果 进行 排序 。 


编译 代码 
e 创建 面向 .NET Framework 3.5 版 的 Visual Studio 项 目 。 默 认 情 况 下 ， 该 项 目 
具有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针对 System.Ling 命名 空间 的 
using 指 今 。 
e 将 代码 复制 到 项 目 中 。 
o TE F5 编译 并 运行 程序 。 
。 按 任意 键 退出 控制 台 窗 口 。 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 


如 何 : 从 方法 中 返回 查询 (CH 编程 指 丙 ) 


此 示例 演示 如 何 从 某 一 方法 以 返回 值 和 out 参数 的 形式 返回 查询 。 


任何 查询 的 类 型 都 必须 为 IEnumerable 或 IEnumerable<T>， 或 一 种 派生 类 型 (如 
IQueryablecT») 。 因 此 ， 返 回 查 询 的 方法 的 任何 返回 值 或 out 参数 也 必须 具有 该 
类 型 。 如 果 某 个 方法 将 查询 具体 化 为 具体 的 List<T> 或 Array 类 型 ， 则 认为 该 方法 
在 返回 查询 结果 (而 不 是 查询 本 身 ) 。 仍 然 能 够 编写 或 修改 从 方法 返回 的 查询 变 


Bo 


在 下 面 的 示例 中 ， 第 一 个 方法 以 返回 值 的 形式 返回 查询 ， 第 二 个 方法 以 out 参数 的 
形式 返回 查询 。 请 注意 ， 在 这 两 种 情况 下 ， 返 回 的 都 是 查询 ， 而 不 是 查询 结果 。 


class MQ 


í 


// QueryMethhodi returns a query as its value. 
IEnumerable<string> QueryMethodi(ref int[] ints) 
{ 
var intsToStrings = from i in ints 
where i > 4 
select 1.ToString(); 
return intsToStrings; 


} 


// QueryMethod2 returns a query as the value of parameter retut 
void QueryMethod2(ref int[] ints, out IEnumerable<string> retut 
{ 
var intsToStrings = from i in ints 
where i < 4 
select i.ToString(); 
returnQ - intsToStrings; 


} 


static void Main() 


{ 
MQ app = new MQ(); 


Int[] mums = { ©, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; 


// QueryMethod1 returns a query as the value of the method 
var myQueryd1 = app.QueryMethodi(ref nums); 


// Query myQuery1 is executed in the following foreach loo; 
Console.WriteLine("Results of executing myQuery1:"); 

// Rest the mouse pointer over myQueryi to see its type. 
foreach (string s in myQuery1) 


Console.WriteLine(s); 


// You also can execute the query returned from QueryMethoc 
// directly, without using myQuery1. 
Console.WriteLine("\nResults of executing myQuery1 directly 
// Rest the mouse pointer over the call to QueryMethod1 to 
// return type. 

foreach (string s in app.QueryMethod1(ref nums)) 


E 
} 


IEnumerable<string> myQuery2; 
// QueryMethod2 returns a query as the value of its out pa! 
app.QueryMethod2(ref nums, out myQuery2); 


Console.WriteLine(s); 


// Execute the returned query. 
Console.WriteLine("NnResults of executing myQuery2:"); 
foreach (string s in myQuery2) 


{ 
j 


// You can modify a query by using query composition. A sa 
// is nested inside a new query definition that revises the 
// of the first query. 
myQuery1 = from item in myQuery1 

orderby item descending 

select item; 


Console.WriteLine(s); 


// Execute the modified query. 
Console.WriteLine("\nResults of executing modified myQuery: 
foreach (string s in myQuery1) 


{ 
} 


// Keep console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


Console.WriteLine(s); 





编译 代码 


e 创建 面向 .NET Framework 3.5 或 更 高 版 本 的 Visual Studio 项 目 。 默 认 情 况 
下 ， 该 项 目 具 有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针对 System.Linq 命 
空间 的 using #8. 


。 将 类 蔡 换 为 示例 中 的 代码 。 


e IZ F5 编译 并 运行 程序 。 
e 按 任意 键 退出 控制 人 台 窗 口 。 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 


如 何 : 在 内 存 中 存储 查询 结果 (CH 编程 指 丙 ) 


查询 基本 上 是 一 组 有 关 如 何 检索 和 组 织 数据 的 指令 。 若 要 执行 查询 ， 需 要 调用 它 的 
GetEnumerator 方法 。 当 您 使 用 foreach 循环 来 循环 访问 元 素 时 ， 将 执行 此 调用 。 
若 要 计算 查询 和 存储 其 结果 ， 而 不 执行 foreach 循环 ， 请 对 查询 变量 调用 下 列 方 法 
之 一 : 


e ToList<TSource> 

e ToArray<TSource> 

e ToDictionary<TSource, TKey, TElement> 
e ToLookup<TSource, TKey, TElement> 


建议 在 存储 查询 结果 时 ， 将 返回 的 集合 对 象 分 配给 一 个 新 变量 ， 如 下 面 的 示例 所 
7: 


class StoreQueryResults 

{ 
static List<int> numbers = new List<int>() { 1, 2, 4, 6, 8, 10, 
static void Main() 


í 


IEnumerable<int> queryFactorsOfFour = 
from num in numbers 
where num % 4 == 
select num; 


// Store the results in a new variable 
// without executing a foreach loop. 
List<int> factorsofFourList = queryFactorsOfFour.ToList(); 


// Iterate the list just to prove it holds data. 
foreach (int n in factorsofFourList) 


{ 
} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key"); 
Console.ReadKey(); 


Console.WriteLine(n); 


j 


«| mmm 








编译 代码 


e 创建 面向 .NET Framework 3.5 版 的 Visual Studio 项 目 。 默 认 情 况 下 ， 该 项 目 
具有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针对 System.Ling 命名 空间 的 
using 指 今 。 

e 将 代码 复制 到 项 目 中 。 

o TE F5 编译 并 运行 程序 。 

e 按 任意 键 退出 控制 台 窗 口 。 


请 参阅 


LINQ 查询 表达 式 (C# 编程 指南 ) 


如 何 : 对 查询 结果 进行 分 组 (CH 编程 指南 ) 

分 组 是 LINQ 最 强大 的 功能 之 一 。 下 面 的 示例 演示 如 何以 各 种 方式 对 数据 进行 分 
组 : 

。 按照 单个 属性 。 

e 按照 字符 串 属性 的 首 字 母 。 

按照 计算 出 的 数值 范围 。 

照 布 尔 谓词 或 其 他 表达 式 。 


e 
CH 
T 
DN 


此 外 ， 最 后 两 个 查询 将 它们 的 结果 投影 到 一 个 新 的 匿名 类 型 中 ， 该 类 型 仅 包 含 学 生 
的 名 字 和 姓氏 。 有 关 更 多 信息 ， 请 参见 group 子 句 (C# 参考 ) 。 


本 主题 中 的 所 有 示例 都 使 用 下 列 帮 助 器 类 和 数据 源 。 


public class StudentClass 

{ 
#region data 
protected enum GradeLevel { FirstYear = 1, SecondYear, ThirdYe: 
protected class Student 


{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
public int ID { get; set; } 
public GradeLevel Year; 
public List<int> ExamScores; 

} 


protected static List<Student> students = new List<Student> 
{ 
new Student {FirstName = "Terry", LastName = "Adams", ID = 
Year = GradeLevel.SecondYear, 
ExamScores = new List<int>{ 99, 82, 81, 79}}, 
new Student {FirstName = "Fadi", LastName = "Fakhouri", ID 
Year = GradeLevel.ThirdYear, 
ExamScores = new List<int>{ 99, 86, 90, 94}}, 
new Student {FirstName = "Hanying", LastName = "Feng", ID : 
Year = GradeLevel.FirstYear, 
ExamScores = new List<int>{ 93, 92, 80, 87}}, 
new Student {FirstName = "Cesar", LastName = "Garcia", ID - 
Year = GradeLevel.FourthYear, 
ExamScores = new List<int>{ 97, 89, 85, 82}}, 
new Student {FirstName = "Debra", LastName = "Garcia", ID : 
Year = GradeLevel.ThirdYear, 
ExamScores = new List<int>{ 35, 72, 91, 70}}, 


new Student {FirstName = "Hugo", LastName = "Garcia", ID = 
Year = GradeLevel.SecondYear, 
ExamScores = new List<int>{ 92, 90, 83, 78}}, 

new Student {FirstName = "Sven", LastName = "Mortensen", II 
Year = GradeLevel.FirstYear, 
ExamScores = new List<int>{ 88, 94, 65, 91}}, 

new Student {FirstName = "Claire", LastName = "O'Donnell", 
Year = GradeLevel.FourthYear, 
ExamScores = new List<int>{ 75, 84, 91, 39}}, 

new Student {FirstName = "Svetlana", LastName = "Omelchenk: 
Year = GradeLevel.SecondYear, 
ExamScores = new List<int>{ 97, 92, 81, 60}}, 

new Student {FirstName = "Lance", LastName = "Tucker", ID - 
Year = GradeLevel.ThirdYear, 
ExamScores = new List<int>{ 68, 79, 88, 92}}, 

new Student {FirstName = "Michael", LastName = "Tucker", II 
Year = GradeLevel.FirstYear, 
ExamScores = new List<int>{ 94, 92, 91, 91}}, 

new Student {FirstName = "Eugene", LastName = "Zabokritski' 
Year = GradeLevel.FourthYear, 
ExamScores = new List<int>{ 96, 85, 91, 60}} 

J; 


#endregion 


//Helper method, used in GroupByRange. 
protected static int GetPercentile(Student s) 
{ 
double avg = s.ExamScores.Average(); 
return avg > © ? (int)avg / 10 : 0; 
} 


public void QueryHighScores(int exam, int score) 


{ 


var highScores = from student in students 
where student.ExamScores[exam] > score 
select new {Name = student.FirstName, Sco! 


foreach (var item in highScores) 


{ 
Console.writeLine("{0, -15}{1}", item.Name, item.Score), 
} 
} 
} 
public class Program 
{ 


public static void Main() 


( 


StudentClass sc - new StudentClass(); 
sc.QueryHighScores(1, 90); 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit"); 


Console.ReadkKey(); 








下 面 的 示例 演示 如 何 通过 使 用 元 素 的 单个 属性 作为 组 键 对 源 元 素 进 行 分 组 。 在 这 种 
情况 下 ， 键 是 string， 即 学 生 的 姓氏 。 还 可 以 使 用 子 字符 串 作 为 键 。 分 组 操作 将 对 


该 类 型 使 用 默认 的 相等 比较 器 。 
将 下 面 的 方法 粘贴 到 StudentClass X: rh, Sf Main 方法 中 的 调用 语句 更 改 为 
sc.GroupBySingleProperty()。 


public void GroupBySingleProperty() 


{ 
Console.WriteLine("Group by a single property in an object:"); 
// Nariable queryLastNames is an IEnumerable<IGrouping<string, 
// DataClass.Student>>. 
var queryLastNames = 
from student in students 
group student by student.LastName into newGroup 
orderby newGroup.Key 
select newGroup; 
foreach (var nameGroup in queryLastNames) 
{ 
Console.WriteLine("Key: {0}", nameGroup.Key); 
foreach (var student in nameGroup) 
{ 
Console.WriteLine("\t{O}, {1}", student.LastName, stud: 
} 
} 
} 
/* Output: 
Group by a single property in an object: 
Key: Adams 
Adams, Terry 
Key: Fakhouri 
Fakhouri, Fadi 
Key: Feng 
Feng, Hanying 
Key: Garcia 
Garcia, Cesar 
Garcia, Debra 
Garcia, Hugo 
Key: Mortensen 
Mortensen, Sven 
Key: O'Donnell 
O'Donnell, Claire 
Key: Omelchenko 
Omelchenko, Svetlana 
Key: Tucker 
Tucker, Lance 
Tucker, Michael 
Key: Zabokritski 
Zabokritski, Eugene 
27. 


E E] 





下 面 的 示例 演示 如 何 通过 使 用 除 对 象 属性 以 外 的 某 个 项 作为 组 键 对 源 元 素 进行 分 
组 。 在 此 示例 中 ， 键 是 学 生 姓氏 的 第 一 个 字母 。 


将 下 面 的 方法 粘贴 到 StudentClass 类 中 。 将 Main 方法 中 的 调用 语句 更 改 为 
sc.GroupBySubstring()。 


public void GroupBySubstring() 


t 
Console.WriteLine("\r\nGroup by something other than a property, 
var queryFirstLetters - 
from student in students 
group student by student.LastName[0]; 
foreach (var studentGroup in queryFirstLetters) 
{ 
Console.WriteLine("Key: {0}", studentGroup.Key); 
// Nested foreach is required to access group items. 
foreach (var student in studentGroup) 
{ 
Console.WriteLine("\t{0}, {1}", student.LastName, stude 
} 
} 
} 
/* Output: 
Group by something other than a property of the object: 
Key: A 
Adams, Terry 
Key: F 
Fakhouri, Fadi 
Feng, Hanying 
Key: G 
Garcia, Cesar 
Garcia, Debra 
Garcia, Hugo 
Key: M 
Mortensen, Sven 
Key: O 
O'Donnell, Claire 
Omelchenko, Svetlana 
Key: T 
Tucker, Lance 
Tucker, Michael 
Key: Z 
Zabokritski, Eugene 
“7 





下 面 的 示例 演示 如 何 通 过 使 用 某 个 数值 范围 作为 组 键 对 源 元 素 进 行 分 组 。 然 后 ， 查 
询 料 结果 投影 到 一 个 匿名 类 型 中 ， 该 类 型 仅 包含 学 生 的 名 字 和 姓氏 以 及 该 学 生 所 属 
的 百分点 范围 。 使 用 匿名 类 型 的 原因 是 没有 必要 使 用 完整 的 Student 对 象 来 显示 结 
果 。 GetPercentile 是 一 个 helper 西数 ， 它 根据 学 生 的 平均 分 数 计算 百分比 。 该 方 
法 返回 0 到 10 之 间 的 整数 。 


//Helper method, used in GroupByRange. 
protected static int GetPercentile(Student s) 


{ 
double avg = s.ExamScores.Average(); 
return avg > © ? (int)avg / 10 : 0; 


将 下 面 的 方法 粘贴 到 StudentClass 类 中 。 将 Main 方法 中 的 调用 语句 更 改 为 
sc.GroupByRange(). 


public void GroupByRange() 


1 
Console.WriteLine("NrNnGroup by numeric range and project into 
var queryNumericRange - 
from student in students 
let percentile - GetPercentile(student) 
group new ( student.FirstName, student.LastName ) by percer 
orderby percentGroup.Key 
select percentGroup; 
// Nested foreach required to iterate over groups and group ite 
foreach (var studentGroup in queryNumericRange) 
1 
Console.WriteLine("Key: {0}", (studentGroup.Key * 10)); 
foreach (var item in studentGroup) 
{ 
Console.WriteLine("\t{O}, {1}", item.LastName, item.Fi! 
} 
} 
} 
/* Output: 
Group by numeric range and project into a new anonymous type: 
Key: 60 
Garcia, Debra 
Key: 70 
O'Donnell, Claire 
Key: 80 
Adams, Terry 
Feng, Hanying 
Garcia, Cesar 
Garcia, Hugo 
Mortensen, Sven 
Omelchenko, Svetlana 
Tucker, Lance 
Zabokritski, Eugene 
Key: 90 
Fakhouri, Fadi 
Tucker, Michael 
a 





下 面 的 示例 演示 如 何 通过 使 用 布尔 比较 表达 式 对 源 元 素 进行 分 组 。 在 此 示例 中 ， 布 
尔 表 达 式 会 测试 学 生 的 平均 考试 分 数 是 否 超过 75。 与 上 述 示例 一 样 ， 结 果 被 投影 到 
一 个 匿名 类 型 中 ， 因 为 不 需要 完整 的 源 元 素 。 请 注意 ， 在 执行 查询 时 ， 该 匿名 类 型 
中 的 属性 将 变 成 Key 成 员 上 的 属性 ， 并 且 可 以 通过 名 称 进 行 访问 。 


将 下 面 的 方法 粘贴 到 StudentClass 类 中 。 将 Main 方法 中 的 调用 语句 更 改 为 
sc.GroupByBoolean()。 


public void GroupByBoolean() 


1 
Console.WriteLine("\r\nGroup by a Boolean into two groups with 
Console.WriteLine("\"True\" and \"False\" and project into a ne 
var queryGroupByAverages - from student in students 
group new { student.FirstName, stud: 
by student.ExamScores.Average(: 
select studentGroup; 
foreach (var studentGroup in queryGroupByAverages) 
{ 
Console.WriteLine("Key: {0}", studentGroup.Key); 
foreach (var student in studentGroup) 
Console.WriteLine("Nt(O) {1}", student.FirstName, stud: 
} 
/* Output: 
Group by a Boolean into two groups with string keys 
"True" and "False" and project into a new anonymous type: 
Key: True 
Terry Adams 
Fadi Fakhouri 
Hanying Feng 
Cesar Garcia 
Hugo Garcia 
Sven Mortensen 
Svetlana Omelchenko 
Lance Tucker 
Michael Tucker 
Eugene Zabokritski 
Key: False 
Debra Garcia 
Claire O'Donnell 
d 





4 — y} 


下 面 的 示例 演示 如 何 使 用 匿名 类 型 来 封装 包含 多 个 值 的 键 。 在 此 示例 中 ， 第 一 个 键 
值 是 学 生 姓 氏 的 第 一 个 字母 。 第 二 个 键 值 是 一 个 布尔 值 ， 它 指定 该 学 生 在 第 一 次 考 
试 中 的 得 分 是 否 超过 了 85。 可 以 按照 该 键 中 的 任何 属性 对 多 组 值 进行 排序 。 


将 下 面 的 方法 粘贴 到 StudentClass X rh, Rf Main 方法 中 的 调用 语句 更 改 为 
sc.GroupByCompositeKey()。 


public void GroupByCompositeKey( ) 


1 
var queryHighScoreGroups - 
from student in students 
group student by new { FirstLetter = student.LastName[0], 
Score = student.ExamScores[0] > 85 } into studentGroup 
orderby studentGroup.Key.FirstLetter 
select studentGroup; 
Console.WriteLine("\r\nGroup and order by a compound key:"); 
foreach (var scoreGroup in queryHighScoreGroups ) 
{ 
string s = scoreGroup.Key.Score == true ? "more than" : "le 
Console.WriteLine("Name starts with {0} who scored {1} 85", 
foreach (var item in scoreGroup) 
{ 
Console.WriteLine("\t{O} {1}", item.FirstName, item.La: 
} 
} 
} 
/* Output: 
Group and order by a compound key: 
Name starts with A who scored more than 85 
Terry Adams 
Name starts with F who scored more than 85 
Fadi Fakhouri 
Hanying Feng 
Name starts with G who scored more than 85 
Cesar Garcia 
Hugo Garcia 
Name starts with G who scored less than 85 
Debra Garcia 
Name starts with M who scored more than 85 
Sven Mortensen 
Name starts with O who scored less than 85 
Claire O'Donnell 
Name starts with O who scored more than 85 
Svetlana Omelchenko 
Name starts with T who scored less than 85 
Lance Tucker 
Name starts with T who scored more than 85 
Michael Tucker 
Name starts with Z who scored more than 85 


Eugene Zabokritski 





将 您 想 要 测试 的 每 种 方法 都 复制 并 粘贴 到 StudentClass 类 中 。 将 该 方法 的 调用 语 
句 添加 到 Main 方法 中 并 按 F5, 


在 改写 这 些 方法 以 适合 您 自己 的 应 用 程序 时 ， 请 记 住 LINQ 需要 NET Framework 
3.5 或 4 版 ， 并 且 项 目 必 须 包含 一 个 对 System.Core.dll 的 引用 和 一 条 针对 
System.Linq 的 using 指令 。LINQ to SQL, LINQ to XML 和 LINQ to DataSet 类 型 
需要 其 他 using 指令 和 3 引用。 有 关 更 多 信息 ， 请 参见 How to: Create a LINQ 
Project。 


请 参阅 

GroupBy<TSource, TKey> 

IGrouping«TKey, TElement> 

LINQ 查询 表达 式 (CH 编程 指南 ) 

group 5 (C£ 参考 ) 

匿名 类 型 (CH 编程 指南 ) 

如 何 : 对 分 组 操作 执行 子 查询 (CH 编程 指南 ) 
如 何 : ej EUER (CH 编程 指南 ) 

Grouping Data 


如 何 : obra (CH 编程 指责) 


下 面 的 示例 演示 如 何在 LINQ 查询 表达 式 中 创建 戏 套 组 。 对 根据 学 生年 级 创建 的 每 
个 组 ， 将 根据 每 个 人 的 姓名 进一步 划分 为 小 组 。 


public void QueryNestedGroups() 


{ 
var queryNestedGroups = 
from student in students 
group student by student.Year into newGroupi 
from newGroup2 in 
(from student in newGroupi 
group student by student.LastName) 
group newGroup2 by newGroup1i.Key; 
// Three nested foreach loops are required to iterate 
// over all elements of a grouped group. Hover the mouse 
// cursor over the iteration variables to see their actual type 
foreach (var outerGroup in queryNestedGroups) 
{ 
Console.WriteLine("DataClass.Student Level = {0}", outerGr« 
foreach (var innerGroup in outerGroup) 
{ 
Console.WriteLine("\tNames that begin with: {0}", inne) 
foreach (var innerGroupElement in innerGroup) 
{ 
Console.WriteLine("NtNt(O) {1}", innerGroupElement 
j 
j 
} 
} 
yt 
Output: 


DataClass.Student Level - SecondYear 
Names that begin with: Adams 
Adams Terry 
Names that begin with: Garcia 
Garcia Hugo 
Names that begin with: Omelchenko 
Omelchenko Svetlana 
DataClass.Student Level - ThirdYear 
Names that begin with: Fakhouri 
Fakhouri Fadi 
Names that begin with: Garcia 
Garcia Debra 
Names that begin with: Tucker 
Tucker Lance 
DataClass.Student Level - FirstYear 
Names that begin with: Feng 


Feng Hanying 

Names that begin with: Mortensen 
Mortensen Sven 

Names that begin with: Tucker 
Tucker Michael 

DataClass.Student Level - FourthYear 

Names that begin with: Garcia 
Garcia Cesar 

Names that begin with: O'Donnell 
O'Donnell Claire 

Names that begin with: Zabokritski 
Zabokritski Eugene 
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编译 代码 


此 示例 包含 对 如 何 : 查询 对 象 集 合 (CH 编程 指南 ) 内 示例 应 用 程序 中 定义 的 对 象 
的 引用 。 若 要 编译 和 运行 此 方法 ， 请 将 它 粘贴 到 该 应 用 程序 的 StudentClass 类 
中 ， 并 且 在 Main 方法 中 添加 对 它 的 调用 。 


在 改写 此 方法 以 适合 您 自己 的 应 用 程序 时 ， 请 记 住 LINQ 需要 .NET Framework 3.5 
版 ， 并 且 项 目 必须 包含 一 个 对 System.Core.dll 的 引用 和 一 条 针对 System.Linq 的 
using #843. LINQ to SQL, FING lo XML 和 LINQ to DataSet 类 型 需要 其 他 using 
指令 和 引用 。 有 关 更 多 信息 ， 请 参见 How to: Create a LINQ Project, 


请 参 阅 
LINQ 查询 表达 式 (CH 编程 指南 ) 


如 何 : 对 分 组 操作 执行 子 查询 (CH 编程 指南 ) 


本 主题 演示 执行 以 下 任务 的 两 种 不 同方 式 : 创建 一 个 查询 ， 以 便 将 源 数 据 排序 到 不 
同 的 组 中 ， 然 后 分 别 对 每 个 组 执行 子 查询 。 每 个 示例 中 的 基本 技术 都 是 使 用 一 个 名 
为 newGroup 的 “延续 ”对 源 元 素 进行 分 组 ， 然 后 生成 一 个 针对 newGroup 的 新 的 子 
查询 。 此 子 查询 是 针对 外 部 查询 所 创建 的 每 个 新 组 运行 的 。 请 注意 ， 在 此 特定 示例 
中 ， 最 终 的 输出 不 是 组 ， 而 是 匿名 类 型 的 平面 序列 。 


有 关 如 何 分 组 的 更 多 信息 ， 请 参见 group fa) (C£ X). 
有 关 延 续 的 更 多 信息 ， 请 参见 into (C# 参考 ) 。 下 面 的 示例 使 用 内 存 中 数据 结构 
作为 数据 源 ， 但 相同 的 原理 适用 于 任何 种 类 的 LINQ 数据 源 。 


public void QueryMax() 


{ 
var queryGroupMax = 
from student in students 
group student by student.Year into studentGroup 
select new 
Level = studentGroup.Key, 
HighestScore = 
(from student2 in studentGroup 
select student2.ExamScores.Average( )).Max() 
J; 
int count = queryGroupMax.Count(); 
Console.WriteLine("Number of groups = {0}", count); 
foreach (var item in queryGroupMax) 
{ 
Console.WriteLine(" {0} Highest Score={1}", item.Level, il 
} 
} 





编译 代码 


此 示例 包含 对 如 何 : 查询 对 象 集 合 (C# 编程 指南 ) 内 示例 应 用 程序 中 定义 的 对 象 
的 引用 。 若 要 编译 和 运行 此 方法 ， 请 将 它 粘贴 到 该 应 用 程序 的 StudentClass 类 
中 ， 并 且 在 Main 方法 中 添加 对 它 的 调用 。 


在 改写 此 方法 以 适合 您 自己 的 应 用 程序 时 ， 请 记 住 LINQ 需要 .NET Framework 3.5 
版 ， 并 且 项 目 必 须 包 含 一 个 对 System.Core.dll 的 引用 和 一 条 针对 System.Linq 的 
using 指令 。LINQ to SQL, LINQ to XML 和 LINQ to DataSet 类 型 需要 其 他 using 
指令 和 引用 。 有 关 更 多 信息 ， 请 参见 How to: Create a LINQ Project. 


MSDN C# 编程 指南 & 参考 手册 2015 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 


如 何 : 对 分 组 操作 执行 子 查询 (C# 编程 指南 ) 373 


如 何 : 按 连 续 键 对 结果 进行 分 组 (CH 编程 指南 ) 


下 面 的 示例 演示 如 何 将 元 素 为 到 不 同 的 块 区 中 ， 块 区 表示 连续 键 的 子 序列 。 例 如 ， 
假设 您 有 下 面 的 键 值 对 序列 : 


键 值 


guo > O U P> D> D> 
医 
3 
a 


将 按照 下 面 的 顺序 创建 以 下 各 组 : 
1. We, think, that 
2. Linq 
3. is 
4. really 
5. cool, ! 
此 解决 方案 作为 扩展 方法 实现 ， 扩 展 方 法 是 线程 安全 的 且 以 流 的 方式 返回 其 结果 。 
也 就 是 说 ， 它 在 移动 通过 源 序列 的 过 程 中 生成 自己 的 各 个 组 。 与 group 或 orderby 
运算 符 不 同 ， 它 可 以 在 整个 序列 读 取 完 毕 之 前 就 开始 将 组 返回 给 调用 方 。 
线程 安全 性 是 通过 在 迭代 源 序列 的 过 程 中 创建 每 个 组 或 块 区 的 副本 来 实现 的 ， 如 源 
代码 注释 中 所 述 。 如 果 源 序列 包含 一 个 由 连续 项 组 成 的 很 大 的 序列 ， 则 公共 语言 运 
行 时 可 能 会 引发 OutOfMemoryException。 
下 面 的 示例 显示 了 此 扩展 方法 及 使 用 它 的 客户 端 代码 。 
using System; 
using System.Collections.Generic; 


using System.Ling; 


namespace ChunkIt 


// Static class to contain the extension methods. 
public static class MyExtensions 


( 


public static IEnumerable<IGrouping<TKey, TSource>> ChunkB\ 


{ 
} 


public static IEnumerable<IGrouping<TKey, TSource>> ChunkB\ 


( 


return source.ChunkBy(keySelector, EqualityComparer«TK: 


// Flag to signal end of source sequence. 
const bool noMoreSourceElements - true; 


// Auto-generated iterator for the source array. 
var enumerator = source.GetEnumerator(); 


// Move to the first element in the source sequence. 
if (!enumerator.MoveNext()) yield break; 


// Iterate through source sequence and create a copy ol 
// On each pass, the iterator advances to the first el: 
// in the source sequence. This loop corresponds to the 
// executes the query. 
Chunk<TKey, TSource> current = null; 
while (true) 
{ 
// Get the key for the current Chunk. The source il 
// the source sequence until it finds an element w: 
var key - keySelector(enumerator.Current); 


// Make a new Chunk (group) object that initially | 
current = new Chunk«TKey, TSource>(key, enumerator, 


// Return the Chunk. A Chunk is an IGrouping<TKey,~ 
// At this point the Chunk only has the first eleme 
// returned only when the client code foreach's ove 
yield return current; 


// Check to see whether (a) the chunk has made a c« 
// (b) the iterator has reached the end of the sou! 
// foreach loop to iterate the chunk items, and thé 
// then the Chunk.GetEnumerator method will alread) 
// copies of all chunk items before we get here. Il 
// enumerate all elements in the chunk, we need to 
// for clients that may be calling us on a separate 
if (current.CopyAllChunkElements() -- noMoreSourcet 


yield break; 


j 


// A Chunk is a contiguous group of one or more source eler 


// has a key and a list of ChunkItem objects, which are co[ 
class Chunk«TKey, TSource> : IGrouping<TKey, TSource> 


D 


// INVARIANT: DoneCopyingChunk -- true || 
// (predicate != null && predicate(enumerator.Current 


// A Chunk has a linked list of ChunkItems, which repre 
// has a reference to the next ChunkItem in the list. 
class ChunkItem 


{ 
public ChunkItem(TSource value) 
{ 
Value = value; 
public readonly TSource Value; 
public ChunkItem Next = null; 
} 


// The value that is used to determine matching element 
private readonly TKey key; 


// Stores a reference to the enumerator for the source 
private IEnumerator<TSource> enumerator; 


// A reference to the predicate that is used to compare 
private Func<TSource, bool> predicate; 


// Stores the contents of the first source element that 
// belongs with this chunk. 
private readonly ChunkItem head; 


// End of the list. It is repositioned each time a new 
// ChunkItem is added. 
private ChunkItem tail; 


// Flag to indicate the source iterator has reached the 
internal bool isLastSourceElement = false; 


// Private object for thread syncronization 
private object m_Lock; 


// REQUIRES: enumerator != null && predicate != null 
public Chunk(TKey key, IEnumerator<TSource> enumerator, 
{ 

this.key = key; 

this.enumerator = enumerator; 

this.predicate = predicate; 


// A Chunk always contains at least one element. 
head = new ChunkItem(enumerator.Current); 


// The end and beginning are the same until the li: 
tail - head; 


m Lock - new object(); 


j 


// Indicates that all chunk elements have been copied 1 
// and the source enumerator is either at the end, or « 
// the tail of the linked list is set to null in the Cc 
// key of the next element does not match the current « 
private bool DoneCopyingChunk ( get { return tail == nt 


// Adds one ChunkItem to the current group 

// REQUIRES: !DoneCopyingChunk && lock(this) 

private void CopyNextChunkElement ( ) 

{ 
// Try to advance the iterator on the source sequer 
// If MoveNext returns false we are at the end, anc 
isLastSourceElement = !enumerator.MoveNext(); 


// If we are (a) at the end of the source, or (b) : 
// then null out the enumerator and predicate for ! 
if (isLastSourceElement || !predicate(enumerator.Ct 
{ 

enumerator = null; 

predicate = null; 


} 


else 


tail.Next = new ChunkItem(enumerator.Current); 


} 


// tail will be null if we are at the end of the cl 
// This check is made in DoneCopyingChunk. 
tail = tail.Next; 

} 


// Called after the end of the last chunk was reached. 
// there are more elements in the source sequence. If 1 
// Returns true if enumerator for this chunk was exhau: 
internal bool CopyAllChunkElements() 


while (true) 


lock (m_Lock) 


{ 
if (DoneCopyingChunk) 


// If isLastSourceElement is false, 
// it signals to the outer iterator 
// to continue iterating. 
return isLastSourceElement; 

} 


else 


{ 
CopyNextChunkElement(); 


} 


public TKey Key { get { return key; } } 


// Invoked by the inner foreach loop. This method stay: 
// of the client requests. It adds the next element of 
// the clients requests the last element in the list s¢ 
public IEnumerator<TSource> GetEnumerator( ) 


{ 
//Specify the initial element to enumerate. 
ChunkItem current = head; 
// There should always be at least one ChunkItem ir 
while (current != null) 
{ 
// Yield the current item in the list. 
yield return current.Value; 
// Copy the next item from the source sequence, 
// if we are at the end of our local list. 
lock (m_Lock) 
{ 
if (current == tail) 
{ 
CopyNextChunkElement(); 
} 
} 
// Move to the next ChunkItem in the list. 
current = current.Next; 
} 
} 
System.Collections.IEnumerator System.Collections.IEnur 
{ 
return GetEnumerator(); 
} 


} 


// A simple named type is used for easier viewing in the debug 
// work just as well with the ChunkBy operator. 
public class KeyValPair 
{ 
public string Key { get; set; } 
public string Value { get; set; } 
} 


class Program 


{ 


// The source sequence. 
public static IEnumerable«KeyValPair» list; 


// Query variable declared as class member to be available 
// on different threads. 
static IEnumerable<IGrouping<string, KeyValPair>> query; 


static void Main(string[] args) 


{ 
// Initialize the source sequence with an array initia. 
list - new[] 
{ 
new KeyValPair{ Key = "A", Value = "We" }, 
new KeyValPair{ Key = "A", Value = "Think" }, 
new KeyValPair{ Key = "A", Value = "That" }, 
new KeyValPair{ Key = "B", Value = "Ling" }, 
new KeyValPair{ Key = "C", Value = "Is" }, 
new KeyValPair{ Key = "A", Value = "Really" }, 
new KeyValPair{ Key = "B", Value = "Cool" }, 
new KeyValPair{ Key = "B", Value = "!" } 
}; 
// Create the query by using our user-defined query ope 
query - list.ChunkBy(p -» p.Key); 
// ChunkBy returns IGrouping objects, therefore a neste 
// foreach loop is required to access the elements in « 
foreach (var item in query) 
{ 
Console.WriteLine("Group key = {0}", item.Key); 
foreach (var inner in item) 
{ 
Console.writeLine("\t{0}", inner.Value); 
} 
} 
Console.WriteLine("Press any key to exit"); 
Console.ReadKey(); 
} 





若 要 在 您 的 项 目 中 使 用 此 扩展 方法 ， 请 将 MyExtensions 静态 类 复制 到 一 个 新 的 或 
现 有 源 代 码 文件 中 ， 并 在 必要 时 ， 为 该 类 所 在 的 命名 空间 添加 一 条 using 指 倒 。 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


Classification of Standard Query Operators by Manner of Execution 


如 何 : 按 连 续 键 对 结果 进行 分 组 (CH 编程 指南 ) 380 


如 何 : 在 运行 时 动态 指定 谓词 筛选 器 (CH 编程 指 
FA) 


在 某 些 情况 下 ， 您 直到 运行 时 才能 知道 必须 将 多 少 个 谓词 应 用 于 where 子 句 中 的 
源 元 素 。 动 态 指定 多 个 谓词 筛选 器 的 一 种 方式 是 使 用 Contains<TSource> Aik, 
如 下 面 的 示例 中 所 示 。 此 示例 按 两 种 方式 构造 。 首 先 ， 通 过 筛选 程序 中 提供 的 值 来 
运行 项 目 。 然 后 ， 使 用 运行 时 提供 的 输入 再 次 运行 项 目 。 


使 用 Contains 方法 进行 筛选 


1. 在 Visual Studio 中 ， 打 开 一 个 新 的 控制 台 应 用 程序 。 将 其 命名 为 
PredicateFilters。 


2. 从 如 何 : 查询 对 象 集合 (CH 编程 指南 ) 中 复制 StudentClass 类 ， 并 将 此 类 粘 
贴 到 Program 类 下 方 的 命名 空间 PredicateFilters 中 。 StudentClass 提供 了 
Student 对 象 的 列表 。 


3. 将 StudentClass 中 的 Main 方法 注释 掉 。 
4. 将 Program 类 蔡 换 为 以 下 代码 。 
class DynamicPredicates : StudentClass 
{ 
static void Main(string[] args) 
string tids = mop TU EI aU: 


Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


} 
static void QueryByID(string[] ids) 
{ 
var queryNames = 
from student in students 
let i = student.ID.ToString() 
where ids.Contains(i) 
select new { student.LastName, student.ID }; 
foreach (var name in queryNames) 
{ 
Console.WriteLine("{0}: {1}", name.LastName, name.I 
} 
} 








. 在 DynamicPredicates 类 的 Main 方法 中 的 ids 声明 下 添加 以 下 行 。 


QueryById(ids); 


. FR F5 运行 项 目 。 
. 命令 提示 符 窗口 中 将 显示 以 下 输出 : 


Garcia: 114 
O'Donnell: 112 
Omelchenko: 111 


一 步 是 重新 运行 项 目 ， 这 次 使 用 在 运行 时 输入 的 输入 内 容 而 不 是 数组 ids 来 
Des 目 。 在 “解决 方案 资源 管理 器 "中 右 击 “PredicateFilters”， 然 后 单 击 “ 属 
性 ”。 


. 单 击 “ 调 试 ”选项 卡 。 
.在 “ 命 爸 行 参数 ”窗口 中 ， 按 如 下 方式 键入 122. 117. 120 和 115 (用 空格 隔 


FF) : 122 117 120 115。 在 运行 项 目 时 ， 这 些 值 将 成 为 Main 方法 的 参数 args 
的 元 素 。 


. 在 Main 方法 中 ， 将 QueryBylD(ids) 更 改 为 QueryBylD(args)。 
. 按 F5 运行 项 目 。 
.命令 提示 符 窗 口中 将 显示 以 下 输出 : 


Adams: 120 
Feng: 117 

Garcia: 115 
Tucker: 122 


使 用 switch ;2 5) 2t 17 j$ 3t 


1. 


可 以 使 用 switch 语句 在 预先 确定 的 各 选 查 询 中 进行 选择 。 在 下 面 的 示例 中 ， 
studentQuery 使 用 的 where 子 句 随 着 在 运行 时 指定 的 年 级 或 年 份 的 不 同 而 不 
同 。 


. 复制 以 下 方法 并 将 其 粘贴 到 类 DynamicPredicates 中 。 


// To run this sample, first specify an integer value of 1 to 4 
// line. This number will be converted to a GradeLevel value tr 
// set of students to query. 

// Call the method: QueryByYear(args[0]); 


static void QueryByYear(string level) 


{ 
GradeLevel year = (GradeLevel)Convert.ToInt32(level); 
IEnumerable&lt;Student&gt; studentQuery = null; 
switch (year) 
case GradeLevel.FirstYear: 
studentQuery - from student in students 
where student.Year -- GradeLevel.Fir 
select student; 
break; 
case GradeLevel.SecondYear: 
studentQuery - from student in students 
where student.Year == GradeLevel.Sec 
select student; 
break; 
case GradeLevel.ThirdYear: 
studentQuery - from student in students 
where student.Year -- GradeLevel.Thi 
select student; 
break; 
case GradeLevel.FourthYear : 
studentQuery - from student in students 
where student.Year == GradeLevel.Fot 
select student; 
break; 
default: 
break; 
} 
Console.WriteLine("The following students are at level {0}" 
foreach (Student name in studentQuery ) 
{ 
Console.WriteLine("{0}: {1}", name.LastName, name. ID); 
} 
} 





3. 在 “命令 行 参数 "窗口 中 ， 将 上 一 过 程 中 的 ID 号 替换 为 一 个 介 于 1 到 4 之 间 的 
整数 值 。 


4. 在 Main 方法 中 ， 将 对 QueryByID 的 调用 替换 为 以 下 调用 ， 此 调用 可 将 args 
数组 中 的 第 一 个 元 素 作 为 其 参数 发 送 : QueryByYear(args[0])。 


5. 按 F5 运行 项 目 。 


在 您 目 己 的 应 用 程序 中 使 用 此 方法 


e 在 改编 此 方法 以 适合 您 自己 的 应 用 程序 时 ， 请 记 住 ，LINQ 需要 版 本 3.5 或 版 
本 4 的 .NET Framework， 并 且 项 目 必 须 包 含 一 个 对 System.Core.dll 的 引用 
和 一 条 针对 System.Ling 的 using #8. LINQ to SQL, LINQ to XML 和 
LINQ to DataSet 类 型 需要 相应 的 其 他 using 指 信 和 引用 。 有 关 更 多 信息 ， 请 
参见 How to: Create a LINQ Project。 


请 参阅 
LINQ 查询 表达 式 (CH 编程 指南 ) 
where F (CH 参考 ) 


如 何 : 执行 内 部 联接 (CH 编程 指 两 ) 


按照 关系 数据 库 的 说 法 , “内 部 联接 "产生 一 个 结果 集 ， 对 于 该 结果 集 内 第 一 个 集合 
中 的 每 个 元 素 ， 只 要 在 第 二 个 集合 中 存在 一 个 匹配 元 素 ， 该 元 素 就 会 出 现 一 次 。 如 
果 第 一 个 集合 中 的 某 个 元 素 没有 匹配 元 素 ， 则 它 不 会 出 现在 结果 集 内 。 Join 方法 
(通过 C# 中 的 join 子 句 调用 ) 可 实现 内 联 。 


本 主题 演示 如 何 执行 内 部 联接 的 四 种 变 体 : 
e 简单 的 内 部 联接 ， 它 基于 一 个 简单 的 键 将 来 自 两 个 数据 源 的 元 素 相 互 关 联 。 


e 内 部 联接 ， 它 基于 一 个 复合 键 将 来 自 两 个 数据 源 的 元 素 相 互 关 联 。 使 用 复合 键 
( 即 由 多 个 值 组 成 的 键 ) 可 以 基于 多 个 属性 将 元 素 相 互 关联 。 


e 多 联接 ， 在 其 中 连续 的 联接 操作 被 相互 拼接 在 一 起 。 
e 通过 使 用 分 组 联接 实现 的 内 部 联接 。 


简单 键 联 接 示 例 


下 面 的 示例 创建 了 两 个 集合 ， 其 中 分 别 包含 以 下 两 个 用 户 定义 类 型 的 对 象 : Person 
和 Pet。 查 询 使 用 C# 中 的 join 子 句 来 将 Person 对 象 与 Pet 对 象 ( 其 Owner 为 该 
Person) 进行 匹配 。C# 中 的 select 子 句 可 定义 生成 的 对 象 的 外 观 。 在 此 示例 中 ， 
生成 的 对 象 是 由 主人 的 名 字 和 完 物 的 名 字 组 成 的 匿名 类 型 。 


class Person 


public string FirstName { get; set; } 
public string LastName { get; set; } 


} 
class Pet 
public string Name { get; set; } 
public Person Owner { get; set; } 
} 


/// «summary» 

/// Simple inner join. 

/// «/summary» 

public static void InnerJoinExample() 


{ 
Person magnus = new Person { FirstName = "Magnus", LastName = ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 


Person rui = new Person { FirstName = "Rui", LastName = "Rapos: 


Pet barley = new Pet { Name = "Barley", Owner = terry }; 


Pet boots = new Pet { Name = "Boots", Owner = terry }; 

Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte ` 
Pet bluemoon = new Pet { Name = "Blue Moon", Owner = rui }; 

Pet daisy = new Pet { Name = "Daisy", Owner = magnus }; 


// Create two lists. 
List<Person> people = new List<Person> { magnus, terry, charlot 
List<Pet> pets = new List<Pet> { barley, boots, whiskers, bluer 


// Create a collection of person-pet pairs. Each element in the 
// iS an anonymous type containing both the person's name and 1 
var query = from person in people 

join pet in pets on person equals pet.Owner 

select new ( OwnerName - person.FirstName, PetName 


foreach (var ownerAndPet in query) 


Console.WriteLine("N"(0)N" is owned by {1}", ownerAndPet.P« 


} 
} 
// This code produces the following output: 
// 


// "Daisy" is owned by Magnus 

// "Barley" is owned by Terry 

// "Boots" is owned by Terry 

// "Whiskers" is owned by Charlotte 
// "Blue Moon" is owned by Rui 


4] — } 


iXX H LastName 为 “Huff'" 的 Person 对 象 未 出 现在 结果 集 内 ， 因 为 不 存在 
Pet.Owner 等 于 该 Person 的 Pet 对 象 。 


复合 键 联接 示例 


与 仅仅 基于 一 个 属性 将 元 素 相互 关联 不 同 ， 使 用 复合 键 可 基于 多 个 属性 来 比较 元 
素 。 为 此 ， 需 要 为 每 个 集合 指定 键 选 择 器 范 数 ， 以 便 返 回 一 个 由 要 比较 的 属性 组 成 
的 匿名 类 型 。 如 果 给 属性 加 上 了 标签 ， 则 这 些 属性 必须 在 每 个 键 的 匿名 类 型 中 都 有 
相同 的 标签 ， 而 且 还 必须 以 相同 顺序 出 现 。 


下 面 的 示例 使 用 一 个 Employee 对 象 列表 和 一 个 Student 对 象 列表 来 确定 哪些 历 员 
同时 还 是 学 生 。 这 两 个 类 型 都 具有 String 类 型 的 FirstName 和 LastName 属性 。 
能 够 从 每 个 列表 的 元 素 创建 联接 键 的 画 数 可 返回 一 个 由 每 个 元 素 的 FirstName 和 
LastName 属性 组 成 的 匿名 类 型 。 联 接 操作 比较 这 些 复合 键 是 否 相 等 ， 并 且 从 每 个 
列表 中 返回 名 字 和 姓氏 都 匹配 的 对 象 对 。 





class Employee 


{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
public int EmployeeID { get; set; } 

} 

class Student 

{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
public int StudentID { get; set; } 

} 


/// <summary> 

/// Performs a join operation using a composite key. 
/// </summary> 

public static void CompositeKeyJoinExample() 


{ 
// Create a list of employees. 
List<Employee> employees = new List<Employee> { 
new Employee { FirstName = "Terry", LastName = "Adams", Emr 
new Employee { FirstName = "Charlotte", LastName = "Weiss' 
new Employee { FirstName = "Magnus", LastName = "Hedland", 
new Employee { FirstName = "Vernette", LastName = "Price", 
// Create a list of students. 
List«Student» students = new List<Student> { 
new Student ( FirstName - "Vernette", LastName - "Price", : 
new Student { FirstName = "Terry", LastName = "Earls", Stu 
new Student { FirstName = "Terry", LastName = "Adams", Stuc 
// Join the two data sources based on a composite key consistir 
// to determine which employees are also students. 
TEnumerable<string> query = from employee in employees 
join student in students 
on new { employee.FirstName, emplo\ 
equals new { student.FirstName, stt 
select employee.FirstName + " " + ¢ 
Console.WriteLine("The following people are both employees and 
foreach (string name in query) 
Console.WriteLine(name); 
} 
// This code produces the following output: 
// 


// The following people are both employees and students: 
// Terry Adams 
// Vernette Price 


4 asa 








多 联接 示例 


可 以 将 任意 数量 的 联接 操作 拼接 在 一 起 以 执行 多 联接 。C# 中 的 每 一 个 join 子 句 都 
可 将 指定 的 数据 源 与 前 一 个 联接 的 结果 相互 关联 。 


下 面 的 示例 创建 了 三 个 集合 : 一 个 Person 对 象 列表 、 一 个 Cat 对 象 列 表 以 及 一 个 
Dog 对 象 列表 。 


C# 中 的 第 一 个 join 子 句 将 基于 匹配 Cat.Owner 的 Person 对 象 对 主人 和 猫 进行 匹 
配 。 并 返回 包含 Person 对 象 和 Cat.Name 的 匿名 类 型 的 序列 。 


CH 中 的 第 二 个 join 子 句 基于 一 个 组 合 键 将 第 一 个 联接 返回 的 匿名 类 型 与 所 提供 的 
大 列表 中 的 Dog 对 象 相互 关联 ， 该 组 合 键 由 类 型 为 Person 的 Owner 属性 和 动物 

名 字 的 首 字 母 组 成 。 该 子 句 返 回 一 个 匿名 类 型 序列 ， 这 些 类 型 包含 每 个 匹配 对 中 的 
Cat.Name 和 Dog.Name 属性 。 由 于 这 是 一 个 内 部 联接 ， 因 此 仅 返 回 第 一 个 数据 源 
中 那些 在 第 二 个 数据 源 中 具有 匹配 对 象 的 对 象 。 


class Person 


{ 
public string FirstName ( get; set; } 
public string LastName { get; set; } 

j 

class Pet 
public string Name { get; set; } 
public Person Owner { get; set; } 

j 

class Cat : Pet 

il 

class Dog : Pet 

f 

public static void MultipleJoinExample() 

{ 
Person magnus = new Person { FirstName = "Magnus", LastName = ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 
Person rui = new Person { FirstName = "Rui", LastName = "Rapos‘ 
Person phyllis = new Person { FirstName = "Phyllis", LastName : 
Cat barley = new Cat { Name = "Barley", Owner = terry }; 
Cat boots = new Cat { Name = "Boots", Owner = terry }; 
Cat whiskers = new Cat ( Name = "Whiskers", Owner = charlotte | 
Cat bluemoon = new Cat { Name = "Blue Moon", Owner = rui }; 
Cat daisy = new Cat { Name = "Daisy", Owner = magnus }; 
Dog fourwheeldrive = new Dog { Name = "Four Wheel Drive", Owne! 


Dog duke = new Dog { Name = "Duke", Owner = magnus }; 


Dog denim = new Dog { Name = "Denim", Owner = terry }; 

Dog wiley = new Dog { Name = "Wiley", Owner = charlotte }; 
Dog snoopy = new Dog { Name = "Snoopy", Owner = rui }; 

Dog snickers = new Dog { Name = "Snickers", Owner = arlene }; 


// Create three lists. 
List<Person> people = 

new List<Person> { magnus, terry, charlotte, arlene, rui, | 
List<Cat> cats = 

new List<Cat> { barley, boots, whiskers, bluemoon, daisy }, 
List<Dog> dogs = 

new List<Dog> { fourwheeldrive, duke, denim, wiley, snoopy, 


// The first join matches Person and Cat.Owner from the list o! 
// cats, based on a common Person. The second join matches dog: 
// with the same letter as the cats that have the same owner. 
var query = from person in people 

join cat in cats on person equals cat.Owner 

join dog in dogs on 

new { Owner = person, Letter = cat.Name.Substring(( 

equals new { dog.Owner, Letter = dog.Name.Substrin: 

select new { CatName = cat.Name, DogName = dog.Name 


foreach (var obj in query) 


{ 
Console.WriteLine( 
"The cat \"{O}\" shares a house, and the first letter « 
obj.CatName, obj.DogName); 
} 
} 
// This code produces the following output: 
// 


// The cat "Daisy" shares a house, and the first letter of their n: 
// The cat "Whiskers" shares a house, and the first letter of thei! 





使 用 分 组 联接 实现 内 部 联接 的 示例 


下 面 的 示例 演示 如 何 使 用 分 组 联接 来 实现 内 部 联接 。 


在 query1 中 ，Person 对 象 列 表 基 于 与 Pet.Owner 属性 匹配 的 Person 分 组 联接 到 
Pet 对 象 列表 。 分 组 联接 创建 了 一 个 中 间 组 集合 ， 该 集合 中 的 每 个 组 都 由 一 个 
Person 对 象 和 匹配 的 Pet 对 象 序列 组 成 。 


通过 向 查询 中 添加 另 一 个 from 子 句 ， 此 序列 的 序列 被 组 合 (或 展 平 ) 为 一 个 较 长 
的 序列 。 最 终 序列 的 元 素 类 型 由 select 子 句 指 定 。 在 此 示例 中 ， 该 类 型 是 由 每 个 匹 
配对 的 Person.FirstName 和 Pet.Name 属性 组 成 的 匿名 类 型 。 


query1 的 结果 等 效 于 使 用 join 子 句 所 获得 的 结果 集 ， 而 没有 into 子 句 执行 内 联 。 
query2 变量 演示 了 这 一 等 效 查 询 。 


class Person 


{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
j 
class Pet 
{ 
public string Name { get; set; } 
public Person Owner { get; set; } 
} 


/// «summary» 

/// Performs an inner join by using GroupJoin(). 
/// </summary> 

public static void InnerGroupJoinExample() 


( 


Person magnus - new Person ( FirstName - "Magnus", LastName - ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 
Pet barley = new Pet { Name = "Barley", Owner = terry }; 

Pet boots = new Pet { Name = "Boots", Owner = terry }; 

Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte : 
Pet bluemoon = new Pet { Name = "Blue Moon", Owner = terry }; 
Pet daisy = new Pet { Name = "Daisy", Owner = magnus }; 


// Create two lists. 
List<Person> people = new List<Person> { magnus, terry, charlot 
List<Pet> pets = new List<Pet> { barley, boots, whiskers, bluer 


var queryi = from person in people 
join pet in pets on person equals pet.Owner into ( 
from subpet in gj 
select new { OwnerName = person.FirstName, PetName 


Console.WriteLine("Inner join using GroupJoin():"); 
foreach (var v in query1) 


{ 
} 


Console.writeLine("{0} - {1}", v.OwnerName, v.PetName); 


var query2 = from person in people 
join pet in pets on person equals pet.Owner 
select new { OwnerName = person.FirstName, PetName 


Console.WriteLine("\nThe equivalent operation using Join():"); 
foreach (var v in query2) 
Console.WriteLine("[0) - {1}", v.OwnerName, v.PetName); 


// This code produces the following output: 


// Inner join using GroupJoin(): 
// Magnus - Daisy 

// Terry - Barley 

// Terry - Boots 

// Terry - Blue Moon 

// Charlotte - Whiskers 


// The equivalent operation using Join(): 
// Magnus - Daisy 

// Terry - Barley 

// Terry - Boots 

// Terry - Blue Moon 

// Charlotte - Whiskers 





编译 代码 
e 在 Visual Studio 中 创建 一 个 新 的 控制 台 应 用 程序 项 目 。 
e 添加 对 System.Core.dll 的 引用 (如 果 尚 未 引用 它 的 话 ) 。 
e 包含 System.Linq 命名 空间 。 


e 从 示例 中 复制 代码 ， 并 将 其 粘贴 到 program.cs 文件 中 的 Main 方法 之 下 。 向 
Main 方法 添加 一 行 代码 ， 以 调用 粘 入 的 方法 。 


e 运行 该 程序 。 


Join 

GroupJoin 

Join Operations 

如 何 : 执行 分 组 联接 (CH 编程 指南 ) 
如 何 : 执行 左 外 部 联接 (CH 编程 指南 ) 
如 何 : 联接 两 个 集合 (CH) (LINQ to XML) 
匿名 类 型 (CH 编程 指南 ) 


匿名 类 型 (Visual Basic) 


如 何 : 执行 分 组 联接 (CH 编程 指 两 ) 


分 组 联接 可 用 于 产生 分 层 数 据 结构 。 它 将 第 一 个 集合 中 的 每 个 元 素 与 第 二 个 集合 中 
的 一 组 相关 元 素 进 行 配对 。 


例如 ， 一 个 名 为 Student 的 类 或 关系 数据 库 表 可 能 包含 两 个 字段 Id 和 Name, X 
一 个 名 为 Course 的 类 或 关系 数据 库 表 可 能 包含 两 个 字段 : Studentld 和 
CourseTitle。 这 两 个 数据 源 的 分 组 联接 (基于 匹配 的 Student.ld 和 
Course.Studentld) 会 将 每 个 Student 与 一 个 Course 对 象 集合 〈 可 能 为 空 ) 组 合 
在 一 起 。 


= = 
Ef TERR 


第 一 个 集合 中 的 每 个 元 素 都 会 出 现在 分 组 联接 的 结果 集 内 ， 而 无 论 是 否 在 第 二 
个 集合 中 找到 相关 元 素 。 如 果 未 找到 相关 元 素 ， 则 该 元 素 的 相关 元 素 序列 为 
空 。 因 此 ， 结 果 选 择 器 可 以 访问 第 一 个 集合 的 每 个 元 素 。 非 分 组 联接 中 的 结果 
es 它 无 法 访问 第 一 个 集合 中 的 那些 在 第 二 个 集合 中 没有 匹配 元 
素 的 元 素 。 


本 主题 中 的 第 一 个 示例 演示 如 何 执行 分 组 联接 ; 第 二 个 示例 演示 如 何 使 用 分 组 联接 
创建 XML 元 素 。 


分 组 联接 示例 


下 面 的 示例 根据 与 Pet.Owner 属性 匹配 的 Person 来 对 Person 和 Pet 类 型 的 对 象 
执行 分 组 联接 。 与 为 每 个 匹配 产生 一 对 元 素 的 非 分 组 联接 不 同 ， 分 组 联接 只 为 第 一 
个 集合 的 每 个 元 素 产 生 一 个 结果 对 象 (在 此 示例 中 为 一 个 Person 对 象 ) 。 第 二 个 
集合 中 的 相应 元 素 (在 此 示例 中 为 Pet 对 象 ) 被 分 组 到 一 个 集合 中 。 最 后 ， 结 果 选 
253 NAST GE Person.FirstName 和 一 个 Pet 对 象 集合 的 匹配 创建 一 个 匿名 


class Person 


public string FirstName { get; set; } 
public string LastName { get; set; } 


} 
class Pet 
public string Name { get; set; } 
public Person Owner { get; set; } 
} 


/// <summary> 

/// This example performs a grouped join. 
/// </summary> 

public static void GroupJoinExample() 


Person magnus - new Person ( FirstName - "Magnus", LastName - ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 
Pet barley = new Pet { Name = "Barley", Owner = terry }; 

Pet boots = new Pet { Name = "Boots", Owner = terry }; 

Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte : 
Pet bluemoon = new Pet { Name = "Blue Moon", Owner = terry }; 
Pet daisy = new Pet { Name = "Daisy", Owner = magnus }; 


// Create two lists. 
List<Person> people = new List<Person> { magnus, terry, charlot 
List<Pet> pets = new List<Pet> { barley, boots, whiskers, bluer 


// Create a list where each element is an anonymous type 
// that contains the person's first name and a collection of 
// pets that are owned by them. 
var query - from person in people 
join pet in pets on person equals pet.Owner into g: 
select new ( OwnerName - person.FirstName, Pets - ( 


foreach (var v in query) 


{ 
// Output the owner's name. 
Console.WriteLine("{0}:", v.OwnerName) ; 
// Output each of the owner's pet's names. 
foreach (Pet pet in v.Pets) 
Console.WriteLine(" {0}", pet.Name); 
} 
} 
// This code produces the following output: 
// 
// Magnus: 
// Daisy 
// Terry: 
// Barley 
// Boots 


Ti Blue Moon 
// Charlotte: 

// Whiskers 

// Arlene: 





执行 分 组 联接 以 创建 XML 的 示例 


分 组 联接 非常 适合 于 使 用 LINQ to XML 来 创建 XML。 下 面 的 示例 与 上 一 个 示例 类 
似 ， 不 同 之 处 在 于 : 结果 选择 器 画 数 创建 表示 已 联接 对 象 的 XML 元素， 而 不 是 创 
建 匿名 类 型 。 有 关 LINQ to XML 的 更 多 信息 ， 请 参见 LINQ to XML. 


class Person 


{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
} 
class Pet 
{ 
public string Name { get; set; } 
public Person Owner { get; set; } 
} 


/// «summary» 

/// This example creates XML output from a grouped join. 
/// </summary> 

public static void GroupJoinXMLExample( ) 


( 


j 


Person magnus - new Person ( FirstName - "Magnus", LastName - ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 
Pet barley = new Pet { Name = "Barley", Owner = terry }; 

Pet boots = new Pet { Name = "Boots", Owner = terry }; 

Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte : 
Pet bluemoon = new Pet { Name = "Blue Moon", Owner = terry }; 
Pet daisy = new Pet { Name = "Daisy", Owner = magnus }; 


// Create two lists. 
List<Person> people = new List<Person> { magnus, terry, charlot 
List<Pet> pets = new List<Pet> { barley, boots, whiskers, bluer 


// Create XML to display the hierarchical organization of peop: 
XElement ownersAndPets - new XElement("PetOwners", 
from person in people 
join pet in pets on person equals pet.Owner into gj 
select new XElement("Person", 
new XAttribute("FirstName", person.FirstName), 
new XAttribute("LastName", person.LastName), 
from subpet in gj 
select new XElement("Pet", subpet.Name))); 


Console.WriteLine(ownersAndPets) ; 


// This code produces the following output: 


// 


// <PetOwners> 


// 
// 
// 


<Person FirstName="Magnus" LastName="Hedlund"> 
<Pet>Daisy</Pet> 
</Person> 


// <Person FirstName="Terry" LastName="Adams"> 


// <Pet>Barley</Pet> 
// <Pet>Boots</Pet> 
// <Pet>Blue Moon</Pet> 


// </Person> 

// <Person FirstName="Charlotte" LastName="Weiss"> 
// <Pet>whiskers</Pet> 

// </Person> 

// «Person FirstName="Arlene" LastName="Huff" /> 
// </PetOwners> 


‘| E — EE 








编译 代码 


e 在 Visual Studio 中 创建 一 个 新 的 “控制 台 应 用 程序 ”项 目 。 


e 添加 一 个 对 System.Core.dll 的 引用 和 一 个 对 System.Xml.Linq.dll 的 引用 (如 
果 它 们 尚未 被 引用 的 话 ) o 


e 包括 System.Linq 和 System.Xml.Linq 命名 空间 。 


e 从 示例 中 复制 代码 ， 并 将 其 粘贴 到 program.cs 文件 中 的 Main 方法 之 下 。 向 
Main 方法 添加 一 行 代码 ， 以 调用 粘 入 的 方法 。 


e 运行 该 程序 。 


Join 

GroupJoin 

Join Operations 

如 何 : 执行 内 部 联接 (CH 编程 指南 ) 
如 何 : 执行 左 外 部 联接 (CH 编程 指南 ) 
LINQ to XML 

匿名 类 型 (CH 编程 指南 ) 


匿名 类 型 (Visual Basic) 


如 何 : 执行 左 外 部 联接 (CH 编程 指南 ) 


左 外 部 联接 是 这 样 一 个 联接 : 在 其 中 返回 第 一 个 集合 的 每 个 元 素 ， 而 无 论 该 元 素 在 
第 二 个 集合 中 是 否 具 有 相关 元 素 。 可 以 使 用 LINQ 执行 左 通过 对 分 组 联接 的 结果 调 
用 方法 DefaultifEmpty<TSource> 外 部 联接 连接 。 


下 面 的 示例 演示 如 何 对 分 组 联接 的 结果 调用 DefaultlfEmpty<TSource> 方法 来 执行 
左 外 部 联接 。 


若 要 生成 两 个 集合 的 左 外 部 联接 ， 第 一 步 是 使 用 分 组 联接 执行 内 部 联接 。 (有 关 此 
过 程 的 说 明 ， 请 参见 如 何 : 执行 内 部 联接 (CH 编程 指南 ) 。) 在 此 示例 中 ， 
Person 对 象 的 列表 内 部 联接 到 Pet 对 象 列表 。Person 对 象 的 匹配 Pet.Owner。 


第 二 步 是 在 结果 集 内 包含 第 一 个 〈 左 ) 集合 的 每 个 元 素 ， 即 使 该 元 素 在 右 集合 中 没 
有 匹配 的 元 素 也 是 如 此 。 这 是 通过 对 分 组 联接 中 的 每 个 匹配 元 素 序 列 调用 
DefaultlfEmpty<TSource> 来 实现 的 。 在 此 示例 中 ，DefaultlfEmpty<TSource> 对 
匹配 Pet 对 象 每 个 序列 。 方 法 返回 一 个 包含 单个 集合 ， 因 此 ， 如 果 匹 配 Pet 对 象 序 
列 为 任何 Person 对 象 为 空 ， 从 而 确保 的 默认 值 每 Person 对 象 在 结果 集合 表示 。 


y 
Ef TER 


引用 类 型 的 默认 值 为 null; 因 此 ， 该 示例 检查 空 在 访问 每 个 Pet 集合 的 每 个 元 素 
之 前 引用 。 


class Person 


{ 
public string FirstName { get; set; } 
public string LastName { get; set; } 
j 
class Pet 
{ 
public string Name { get; set; } 
public Person Owner { get; set; } 
} 
public static void LeftOuterJoinExample() 
{ 
Person magnus = new Person { FirstName = "Magnus", LastName = ' 
Person terry = new Person { FirstName = "Terry", LastName = "Ac 
Person charlotte = new Person { FirstName = "Charlotte", LastN: 
Person arlene = new Person { FirstName = "Arlene", LastName = ' 
Pet barley = new Pet { Name = "Barley", Owner = terry }; 
Pet boots = new Pet { Name = "Boots", Owner = terry }; 
Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte : 
Pet bluemoon = new Pet { Name = "Blue Moon", Owner = terry }; 
Pet daisy = new Pet { Name = "Daisy", Owner = magnus }; 
// Create two lists. 
List<Person> people = new List<Person> { magnus, terry, charlot 
List<Pet> pets = new List<Pet> { barley, boots, whiskers, bluer 
var query = from person in people 
join pet in pets on person equals pet.Owner into g: 
from subpet in gj.DefaultlIfEmpty() 
select new { person.FirstName, PetName = (subpet =: 
foreach (var v in query) 
{ 
Console.WriteLine("{0, -15}{1}", v.FirstName + ":", v.PetNar 
} 
} 
// This code produces the following output: 
// 
// Magnus: Daisy 
// Terry: Barley 
// Terry: Boots 
// Terry: Blue Moon 
// Charlotte: Whiskers 


// Arlene: 








编译 代码 
e 在 Visual Studio 中 创建 一 个 新 的 控制 台 应 用 程序 项 目 。 
e 添加 对 System.Core.dll 的 引用 (如 果 尚 未 引用 它 的 话 ) 。 
e 包 合 System.Lind 命名 空间 。 


。 复制 和 粘贴 该 示例 的 代码 添加 到 program.cs 文件 中 ， 在 Program 选 件 类 的 
Main 方法 。 添 加 代码 行 。Main 方法 调用 LeftOuterJoinExample 方法 。 


e 运行 该 程序 。 


Join 

GroupJoin 

Join Operations 

如 何 : 执行 内 部 联接 (CH 编程 指南 ) 
如 何 : 执行 分 组 联接 (CH 编程 指南 ) 
匿名 类 型 (CH 编程 指南 ) 


匿名 类 型 (Visual Basic) 


如 何 : 对 Join 子 句 的 结果 进行 排序 (CH 编程 指 
南 ) 


RB a pe ER 执行 的 。 
忌 管 可 以 在 联接 之 前 将 orderby 子 句 用 于 一 个 或 多 个 源 序列 ， 但 通常 我 们 不 建议 这 
样 做 。 某 些 LINQ 提供 程序 可 能 不 会 在 联接 之 后 保留 排序 。 


此 查询 将 创建 一 个 分 组 联接 ， 然后 基于 类 别 元 素 〈 仍 然 在 范围 中 ) 对 组 进行 排序 。 
在 匿名 类 型 初始 值 设 定 项 中 ， 子 查询 将 对 产 品 序列 中 的 所 有 匹配 元 素 进 TT HER. 


class HowToOrder Joins 
1 
4region Data 
class Product 


public string Name { get; set; } 
public int CategoryID { get; set; } 
j 


class Category 


public string Name ( get; set; j 
public int ID { get; set; } 
} 


// Specify the first data source. 
List<Category> categories = new List<Category>() 


new Category(){Name="Beverages", ID=001}, 
new Category(){ Name="Condiments", ID=002}, 
new Category(){ Name="Vegetables", ID=003}, 
new Category() { Name="Grains", ID=004}, 
new Category() { Name="Fruit", ID=005} 


I 


// Specify the second data source. 
List<Product> products = new List<Product>() 


new Product{Name="Cola", CategoryID=001}, 
new Product{Name="Tea", CategoryID=001}, 

new Product{Name="Mustard", CategoryID=002}, 
new Product{Name="Pickles", CategoryID-002], 
new Product{Name="Carrots", CategoryID-003], 
new Product{Name="Bok Choy", CategoryID=003}, 
new Product{Name="Peaches", CategoryID=005}, 
new Product{Name="Melons", CategoryID=005}, 


#endregion 


static void Main() 


( 


j 


HowToOrderJoins app = new HowToOrder Joins(); 
app.OrderJoini(); 


// Keep console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


void OrderJoini() 


( 


j 


var groupJoinQuery2 - 

from category in categories 

join prod in products on category.ID equals prod.t 

orderby category.Name 

select new 

1 
Category 
Products 


category.Name, 

from prod2 in prodGroup 
orderby prod2.Name 
select prod2 


ig 


foreach (var productGroup in groupJoinQuery2) 


1 
Console.WriteLine(productGroup.Category); 
foreach (var prodItem in productGroup.Products) 


E 
} 


Console.writeLine("  (0,-10) {1}", prodItem.N: 


} 


/* Output: 


4 


Beverages 
Cola 1 
Tea 1 
Condiments 
Mustard 2 
Pickles 2 
Fruit 
Melons 5 
Peaches 5 
Grains 
Vegetables 
Bok Choy 3 
Carrots 3 








编译 代码 


e 创建 面向 .NET Framework 3.5 版 的 Visual Studio MB. Rite F, wme 
具有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针对 System.Linq 命名 空间 的 
using 指 今 。 

e 将 代码 复制 到 项 目 中 。 

。 按 F5 编译 并 运行 程序 。 

按 任意 键 退 出 控制 台 窗 口 。 


请 参阅 

LINQ 查询 表达 式 (CH 编程 指南 ) 
orderby £^] (CH 参考 ) 

join F (CH 参考 ) 


Join Operations 


如 何 : 使 用 复合 键 进行 联接 (CH 编程 指南 ) 


此 示例 演示 如 何 执行 想 要 使 用 多 个 键 来 定义 匹配 的 联接 操作 。 使 用 组 合 键 来 完成 此 
操作 。 以 匿名 类 型 或 包含 要 比较 的 值 的 命名 类 型 的 形式 来 创建 组 合 键 。 如 果 将 跨 方 
法 边界 传递 查询 变量 ， 请 使 用 为 该 键 重 写 Equals 和 GetHashCode 的 命名 类 型 。 
属性 的 名 称 以 及 属性 出 现 的 顺序 在 每 个 键 中 必须 相同 。 
下 面 的 示例 演示 如 何 使 用 组 合 键 来 联接 来 自 三 个 表 中 的 数据 : 
var query = from o in db.Orders 
from p in db.Products 
join d in db.OrderDetails 
on new (o.OrderID, p.ProductID) equals new {d.OrderID, 
d.ProductID) into details 


from d in details 
select new ([o.OrderID, p.ProductID, d.UnitPrice}; 


组 合 键 上 的 类 型 推理 取决 于 这 些 键 中 属性 的 名 称 ， 以 及 属性 的 出 现 顺 序 。 如 果 源 序 
列 中 属性 的 名 称 不 同 ， 您 必须 在 键 中 分 配 新 名 称 。 例 如 ， 如 果 Orders 表 和 
OrderDetails 表 各 自 为 它们 的 列 使 用 不 同 的 名 称 ， 则 您 将 通过 在 匿名 类 型 中 分 配 相 
同 的 名 称 来 创建 组 合 键 : 


join...on new (Name = o.CustomerName, ID = o.CustID) equals 
new {Name = d.CustName, ID = d.CustID } 


还 可 以 在 group 子 句 中 使 用 组 合 键 。 


编译 代码 


。 知 要 编译 并 运行 此 代码 ， 请 按 下 面 的 步骤 进行 操作 : 


。 打 开 如 何 : 连接 到 Northwind 数据 库 ， 并 按照 说 明 进 行 操作 来 设置 项 目 并 创建 
数据 库 连 接 。 有 关 更 多 信息 ， 请 参见 如 何 : 安装 示例 数据 库 。 


e 在 samples.cs 中 创建 一 个 新 的 空 方法 ， 该 方法 采用 名 为 db 的 Northwind 输入 
BR (与 该 文件 中 的 其 他 方法 类 似 ) 。 将 此 示例 中 的 代码 粘贴 到 方法 体 中 。 


e 修改 program.cs 以 从 Main 中 调用 该 新 方法 。 
e TR F5 编译 并 运行 查询 。 


请 参阅 


MSDN C# 编程 指南 & 参考 手册 2015 


LINQ 查询 表达 式 (CH 编程 指南 ) 
join F (C£ 参考 ) 
group £4) (CH 2) 


如 何 : 使 用 复合 键 进行 联接 (CH 编程 指南 ) 403 


如 何 : 执行 目 定 义 联接 操作 (CH 编程 指南 ) 


此 示例 演示 如 何 执行 无 法 使 用 join 子 句 执行 的 联接 操作 。 在 查询 表达 式 中 ，join F 
句 仅 适用 于 同等 联接 (这 是 迄今 为 止 最 常见 的 联接 操作 类 型 ) ， 并 针对 同等 联接 进 
行 了 优化 。 执 行 同 等 联接 时 ， 一 般 总 是 可 以 通过 使 用 join 子 句 获得 最 佳 性 能 。 
但 是 ， 在 下 面 一 些 情况 中 ， 无 法 使 用 join 子 句 : 

e 联接 是 在 不 等 式 ( 非 同等 联接 ) 上 断言 的 。 

e 联接 是 在 多 个 等 式 或 不 等 式 上 断言 的 。 

e 必须 在 联接 操作 之 前 为 右 侧 (内部) 序列 引入 一 个 临时 范围 变量 。 
若 要 执行 非 同等 联接 ， 可 以 使 用 多 个 from 子 句 单独 引入 每 个 数据 源 。 然 后 ， 在 
where 子 句 中 将 谓词 表达 式 应 用 于 每 个 源 的 范围 变量 。 该 表达 式 还 可 以 采用 方法 调 
用 的 形式 。 

8 注意 

不 要 将 这 种 自 定 义 联接 操作 与 使 用 多 个 from 子 句 访问 内 部 集合 相 混 淆 。 有 关 更 

多 信息 ， 请 参见 join ta (C# 参考 ) 。 


下 面 示 例 中 的 第 一 个 方法 演示 了 一 个 简单 的 交叉 联接 。 必 须 愤 用 交叉 联接 ， 因 为 它 
们 可 能 产生 非常 大 的 结果 集 。 但 在 某 些 方案 中 ， 可 以 使 用 它们 创建 源 序 列 以 供 运行 
附加 查询 。 


第 二 个 方法 产生 其 类 别 ID 列 在 左 侧 类 别 列表 中 的 所 有 产品 的 序列 。 请 注意 ， 这 种 
方法 使 用 let 子 句 和 Contains 方法 创建 了 一 个 临时 数组 。 还 可 以 在 查询 前 创建 该 
数组 并 去 掉 第 一 个 from 子 句 。 


class CustomJoins 
{ 
#region Data 
class Product 
public string Name { get; set; } 
public int CategoryID { get; set; } 
} 
class Category 
public string Name { get; set; } 
public int ID { get; set; } 
} 


// Specify the first data source. 


HH 


I 


List<Category> categories = new List<Category>() 


new Category(){Name="Beverages", ID=001}, 
new Category(){ Name="Condiments", ID=002}, 
new Category(){ Name="Vegetables", ID=003}, 


new 
new 
new 
new 
new 
new 
new 
new 
new 


// Specify the second data source. 
List<Product> products = new List<Product>() 


Product{Name="Tea",  CategoryID-001), 
Product{Name="Mustard", CategoryID=002}, 
Product{Name="Pickles", CategoryID=002}, 
Product{Name="Carrots", CategoryID=003}, 
Product{Name="Bok Choy", CategoryID=003}, 
Product{Name="Peaches", CategoryID-005), 
Product{Name="Melons", CategoryID=005}, 
Product{Name="Ice Cream", CategoryID=007}, 
Product{Name="Mackerel", CategoryID-012], 


#endregion 


static void Main() 


{ 


} 


CustomJoins app = new CustomJoins(); 
app.CrossJoin(); 
app .NonEquijoin(); 


Console.WriteLine("Press any key to exit."); 


Console.ReadKey(); 


void CrossJoin() 


{ 


} 


var crossJoinQuery = 
from c in categories 
from p in products 
select new { c.ID, p.Name }; 


Console.WriteLine("Cross Join Query:"); 
foreach (var v in crossJoinQuery) 


{ 
} 


Console.writeLine("{0,-5}{1}", v.ID, 


void NonEquijoin() 


i 


var nonEquijoinQuery - 
from p in products 
let catIds = from c in categories 
select c.ID 
where catIds.Contains(p.CategoryID) 


V. 


Name); 


true 


select new { Product = p.Name, CategoryID = p.Cate 
Console.WriteLine("Non-equijoin query:"); 
foreach (var v in nonEquijoinQuery ) 


{ 
} 


Console.WriteLine("{0, -5}{1}", v.CategoryID, v.Pr« 


} 
} 
/* Output: 
Cross Join Query: 
Tea 
1 Mustard 
1 Pickles 
1 Carrots 
1 Bok Choy 
1 Peaches 
1 Melons 
1 Ice Cream 
1 Mackerel 
2 Tea 
2 Mustard 
2 Pickles 
2 Carrots 
2 Bok Choy 
2 Peaches 
2 Melons 
2 Ice Cream 
2 Mackerel 
3 Tea 
3 Mustard 
3 Pickles 
3 Carrots 
3 Bok Choy 
3 Peaches 
3 Melons 
3 Ice Cream 
3 Mackerel 
Non-equijoin query: 
1 Tea 
2 Mustard 
2 Pickles 
3 Carrots 
3 Bok Choy 
Press any key to exit. 
aa 


4 — g 
在 下 面 的 示例 中 ， 坦 询 必须 基于 匹配 键 联接 两 个 序列 ， 而 对 于 内 部 (Am) 序列 而 


言 ， 无 法 在 join 子 句 本 身 之 前 获取 这 些 键 。 如 果 此 联接 是 使 用 join 子 句 执 行 的 ， 
则 必须 为 每 个 元 素 调 用 Split 方法 。 使 用 多 个 from 子 句 可 使 查询 避免 反复 进行 方 





法 调用 的 系统 开销 。 然 而 ， 由 于 join 进行 了 优化 ， 因 此 在 此 特定 情况 下 ， 它 仍然 可 
能 比 使 用 多 个 from 子 句 快 。 结 果 会 有 所 不 同 ， 主 要 取决 于 方法 调用 的 系统 开销 有 


多 大 。 


class MergeTwoCSVFiles 


( 


j 


static void Main() 


( 


// See section Compiling the Code for information about the 
string[] names - System.IO.File.ReadAllLines(Q"../../../nar 
string[] scores = System.IO.File.ReadAllLlines(Q"../../../s« 


// Merge the data sources using a named type. 
// You could use var instead of an explicit type for the qti 
IEnumerable«Student» queryNamesScores = 
// Split each line in the data files into an array of : 
from name in names 
let x = name.Split(',') 
from score in scores 
let s = score.Split(',') 
// Look for matching IDs from the two data files. 
where x[2] == s[0] 
// If the IDs match, build a Student object. 
select new Student() 


{ 
FirstName = x[0], 
LastName = x[1], 
ID = Convert.ToInt32(x[2]), 
ExamScores = (from scoreAsText in s.Skip(1) 
select Convert.ToInt32(scoreAsText ) ) 
ToList() 
}; 


// Optional. Store the newly created student objects in mer 
// for faster access in future queries 
List«Student» students = queryNamesScores.ToList(); 


foreach (var student in students) 
{ 
Console.WriteLine("The average score of {0} {1} is {2} 
student.FirstName, student.LastName, student.ExamS<¢ 


j 


//Keep console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


class Student 


{ 


public string FirstName { get; set; } 


public string LastName { get; set; } 
public int ID { get; set; } 
public List<int> ExamScores { get; set; } 


j 


/* Output: 
The average score of Omelchenko Svetlana is 82.5. 
The average score of O'Donnell Claire is 72.25. 
The average score of Mortensen Sven is 84.5. 
The average score of Garcia Cesar is 88.25. 
The average score of Garcia Debra is 67. 
The average score of Fakhouri Fadi is 92.25. 
The average score of Feng Hanying is 88. 
The average score of Garcia Hugo is 85.75. 
The average score of Tucker Lance is 81.75. 
The average score of Adams Terry is 85.25. 
The average score of Zabokritski Eugene is 83. 
The average score of Tucker Michael is 92. 





编译 代码 


e 创建 一 个 面向 .NET Framework 3.5 或 更 高 版 本 的 Visual Studio 控制 台 应 用 程 
序 项 目 。 默 认 情况 下 ， 该 项 目 具 有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针 
对 System.Ling 命名 空间 的 using 指 今 。 


将 Program 类 替换 为 上 述 示例 中 的 代码 。 


按照 How to: Join Content from Dissimilar Files (LINQ) 中 的 指使 设置 数据 文件 
(scores.csv 和 names.csv) 。 


按 F5 编译 并 运行 程序 。 
按 任意 键 退出 控制 台 窗 口 。 


LINQ 查询 表达 式 (CH 编程 指南 ) 
join FA (CH 参考 ) 
Join Operations 


如 何 : 对 Join 子 句 的 结果 进行 排序 (CH 编程 指南 ) 


如 何 : {EB 询 表 达 式 中 处理 Null fü (CH 编程 指 
Fa) 


此 示例 演示 如 何 处 理 源 集合 中 可 能 的 null 值 。 诸 如 IEnumerablecT» Sx REA A 
能 包含 值 为 null 的 元 素 。 如 果 源 集合 为 null 或 包含 值 为 null 的 元 素 ， 并 且 查 询 未 处 
H null 值 ， 当 您 执行 查询 时 将 会 引发 NullReferenceException。 


您 可 以 采用 防御 方式 进行 编码 以 避免 null 引用 异常 ， 如 下 面 的 示例 中 所 示 : 


var query1 = 
from c in categories 
where c !- null 
join p in products on c.ID equals 
(p == null ? null : p.CategoryID) 
select new ( Category = c.Name, Name = p.Name }; 


在 前 面 的 示例 中 ，where 子 句 筛选 出 类 别 序 列 中 的 所 有 null 元 素 。 此 技术 与 join F 
句 中 的 null 检查 无 关 。 此 示例 中 包含 null 的 条 件 表 达 式 将 发 挥 作用 ， 因 为 
Products.CategoryID 的 类 型 为 int? (Nullable<int> 的 简写 形式 ) 。 


在 join 子 句 中 ， 只 要 其 中 一 个 比较 键 是 可 以 为 null 的 类 型 ， 您 就 可 以 在 查询 表达 式 
中 将 另 一 个 比较 键 强制 转换 成 可 以 为 null 的 类 型 。 在 下 面 的 示例 中 ， 假 定 
EmployeelD 是 一 个 列 ， 其 中 包含 类 型 为 int? 的 值 : 


void TestMethod(Northwind db) 


{ 
var query = 
from o in db.Orders 
join e in db.Employees 
on o.EmployeeID equals (int?)e.EmployeeID 

select new ( o.OrderID, e.FirstName }; 

} 

请 参阅 


Nullable<T> 
LINQ 查询 表达 式 (CH 编程 指南 ) 
可 以 为 null 的 类 型 (CH 编程 指南 ) 


如 何 : 在 查询 表达 式 中 处 理 异 党 (C# EHA) 


可 以 在 查询 表达 式 的 上 下 文中 调用 任何 方法 。 但 是 ， 建 议 您 避免 在 查询 表达 式 中 调 
用 任何 可 能 产生 副作用 (例如 ， 修 改 数据 源 的 内 容 或 引发 异常 ) 的 方法 。 此 示例 演 
示 在 查询 表达 式 中 调用 方法 时 如 何 避 免 引 发 异常 ， 同 时 又 不 违反 NET Framework 
的 有 关 异 常 处 理 的 一 般 性 准则 。 这 些 准则 说 明 : 如 果 您 了 解 为 什么 在 给 定 上 下 文中 
3 evan DodtUIUerhi CSS Oe UMEN 


最 后 一 个 示例 演示 如 何 处 理 那 些 必须 在 查询 执行 过 程 中 引发 异常 的 情况 。 


下 面 的 示例 演示 如 何 将 异常 处 理 代码 移 至 查询 表达 式 外 部 。 仅 当 该 方法 不 依赖 于 查 
询 的 任何 本 地 变量 时 ， 才 能 这 样 做 。 


class ExceptionsOutsideQuery 
{ 
static void Main() 
{ 
// DO THIS with a datasource that might 
// throw an exception. It is easier to deal with 
// outside of the query expression. 
IEnumerable<int> dataSource; 
try 
{ 


dataSource = GetData(); 


catch (InvalidOperationException) 
{ 
// Handle (or don't handle) the exception 
// in the way that is appropriate for your application 
Console.WriteLine("Invalid operation"); 
goto Exit; 
} 


// If we get here, it is safe to proceed. 
var query = from i in dataSource 
select i * i; 


foreach (var i in query) 
Console.WriteLine(i.ToString()); 


//Keep the console window open in debug mode 
Exit: 

Console.WriteLine("Press any key to exit"); 
Console.ReadKey(); 


j 


// A data source that is very likely to throw an exception! 
static IEnumerable<int> GetData() 


{ 
} 


throw new InvalidOperationException(); 


} 
二 "| 


在 某 些 情况 下 ， 对 在 查询 内 引发 的 异常 的 最 佳 响 应 可 能 是 立即 停止 执行 查询 。 下 面 
的 示例 演示 如 何 处 理 可 能 从 查询 正文 内 部 引发 的 有 异常。 假定 
SomeMethodThatMightThrow 可 能 导致 要 求 停止 执行 查询 的 异常 。 


请 注意 ，try 24 foreach 循环 而 不 是 查询 本 身 封闭 起 来 。 这 是 因为 foreach 循环 
是 实际 执行 查询 的 场所 。 有 关 更 多 信息 ， 请 参见 Introduction to LINQ Queries 
(C#). 


class QueryThatThrows 


( 


static void Main() 
{ 
// Data source. 
string[] files = { "fileA.txt", "fileB.txt", "fileC.txt" Y; 


// Demonstration query that throws. 

var exceptionDemoQuery - 
from file in files 
let n - SomeMethodThatMightThrow(file) 
select n; 


// Runtime exceptions are thrown when query is executed. 
// Therefore they must be handled in the foreach loop. 
try 

{ 


foreach (var item in exceptionDemoQuery ) 


{ 
} 


Console.WriteLine("Processing {0}", item); 


j 


// Catch whatever exception you expect to raise 
// and/or do any necessary cleanup in a finally block 
catch (InvalidOperationException e) 


{ 
} 


//Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit"); 
Console.ReadKey(); 


Console.WriteLine(e.Message); 


} 


// Not very useful as a general purpose method. 
static string SomeMethodThatMightThrow(string s) 


if (s[4] == 'C') 
throw new InvalidOperationException(); 
return @"C:\newFolder\" + s; 
} 
} 
/* Output: 
Processing C:\newFolder\fileA.txt 
Processing C:\newFolder\fileB.txt 


Operation is not valid due to the current state of the object. 
"y 


4 a 





编译 代码 


e 创建 面向 .NET Framework 3.5 版 的 Visual Studio 项 目 。 默 认 情 况 下 ， 该 项 目 
具有 一 个 对 System.Core.dll 的 引用 以 及 一 条 针对 System.Ling 命名 空间 的 
using 指 今 。 


e 将 代码 复制 到 项 目 中 。 
e 按 F5 编译 并 运行 程序 。 
按 任意 键 退出 控制 台 窗口 。 
请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 


Main() AMATA (CH 编程 指南 ) 
Main 方 法 是 C# 控制 台 应 用 程序 或 窗口 应 用 程序 的 入 口 点 。 〈 库 和 服务 不 要 求 将 
Main 方法 作为 入 口 点 。) 应 用 程序 启动 时 ，Main 方法 是 第 一 个 调用 的 方法 。 


C# 程序 中 只 能 有 一 个 人 口 点 。 如 果 您 有 多 个 类 都 包含 Main 方法 ， 则 必须 使 用 
/main 编译 器 选项 编译 您 的 程序 ， 以 指定 用 作 入 口 点 的 Main 方法 。 有 关 更 多 信 
息 ， 请 参见 /main (C# Compiler Options)。 


class TestClass 


{ 
static void Main(string[] args) 
// Display the number of command line arguments: 
System.Console.WriteLine(args.Length); 
} 
} 


e Main 方法 是 .exe 程序 的 入 口 点 ， 程 序 控制 流 在 该 处 开始 和 结 


e Main 在 类 或 结构 内 声明 。 Main 必须 是 静态 ， 且 不 应 该 是 公开 。 (在 前 面 的 
示例 中 ， 它 接受 默认 访问 级 别 private。) 但 不 要 求 封 闭 类 或 结构 是 静态 的 。 


e Main 的 返回 类 型 有 两 种 : void x int. 
e 所 声明 的 Main 方法 可 以 具有 包含 命令 行 实 参 的 string[] 形 参 ， 也 可 以 不 具有 这 
样 的 形 参 。 使 用 Visual Studio 创建 Windows 窗 体 应 用 程序 时 ， 可 以 手动 添加 


形 参 ， 也 可 以 使 用 Environment 类 获取 命令 行 实 参 。 形 参 读 取 为 雾 索 引 的 命令 
行 参 数 。 与 C 和 C++ 不 同 ， 程 序 的 名 称 视 为 第 一 个 命令 行 参 数 。 


e 命令 行 参数 (CH 编程 指南 ) 

e 如 何 : 显示 命令 行 参 数 (CH 编程 指南 ) 

e 如 何 : 使 用 foreach 访问 命令 行 参数 (CH 编程 指南 ) 
。 Main() 返回 值 (C# 编程 指南 ) 


MSDN CZ 编程 指南 & 参考 手册 2015 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

Command-ine Building With csc.exe 
C# 编程 指南 

方法 (CH 编程 指南 ) 

在 C# 程序 内 部 


<paveover>C# Sample Applications 


Main() 和 命令 行 参数 (CH 编程 指南 ) 
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命令 行 参 数 (CH 编程 指南 ) 
通过 以 下 方式 之 一 定义 方法 ， 可 以 将 参数 发 送 至 Main 方法 。 


static int Main(string[] args) 
static void Main(string[] args) 


区 注意 

BEE Windows 窗 体 应 用 程序 中 的 Main 方法 中 启用 命令 行 参 数 ， 必 须 手 动 修 
eX program.cs 中 Main 的 签名 。Windows 窗 体 设计 器 生成 的 代码 创建 没有 输入 
参数 的 Main。 也 可 以 使 用 Environment.CommandLine 或 
Environment.GetCommandLineArgs 从 控制 台 或 Windows 应 用 程序 中 的 任何 


位 置 访问 命令 行 参数 。 


Main 方法 的 参数 是 表示 命令 行 参数 的 String 数组 。 一 般 是 通过 测试 Length 属性 来 
确定 参数 是 否 存 在 ， 例 如 : 


if (args.Length == 0) 
{ 


System.Console.WriteLine("Please enter a numeric argument."); 
return 1; 


} 
BE a) 
还 可 以 使 用 Convert 类 或 Parse 方法 将 字符 串 参 数 转换 为 数值 类 型 。 例 如 ， 下 面 的 
语句 使 用 Parse 方法 将 string 转换 为 long 数字 : 


long num = Int64.Parse(args[0]); 
也 可 以 使 用 别名 为 Int64 的 C# 类 型 long : 
long num = long.Parse(args[0]); 


还 可 以 使 用 Convert 类 的 方法 Tolnt64 完成 同样 的 工作 : 


long num = Convert.ToInt64(s); 


有 关 更 多 信息 ， 请 参见 Parse 和 Convert。 


下 面 的 示例 演示 如 何在 控制 台 应 用 程序 中 使 用 命令 行 参数 。 应 用 程序 在 运行 时 采用 
一 个 参数 ， 将 该 参数 转换 为 整数 ， 并 计算 该 数 的 阶乘 。 如 果 没 有 提供 参数 ， 则 应 用 
程序 发 出 一 条 消息 来 解释 程序 的 正确 用 法 。 


若 要 根据 命 信 提 示 编 译 并 运行 应 用 程序 ， 请 执行 以 下 步骤 : 
1. 将 以 下 代码 粘贴 到 任何 文本 编辑 器 中 ， 并 将 文件 保存 为 名 为 Factorial.cs HIX 


本 文件 。 


//Add a using directive for System if the directive isn't alree 


public class Functions 


{ 


public static long Factorial(int n) 


{ 


} 


// Test for invalid input 
if ((n &lt; ©) || (n &gt; 20)) 
{ 


} 


return -1; 


// Calculate the factorial iteratively rather than rect 
long tempResult - 1; 
for (int i = 1; i &lt;= n; i++) 


{ 
} 


return tempResult; 


tempResult *= i; 


class MainClass 


( 


static int Main(string[] args) 


( 


// Test if input arguments were supplied: 
if (args.Length -- 0) 


{ 
System.Console.WriteLine("Please enter a numeric ar 
System.Console.WriteLine("Usage: Factorial &lt;numé 
return 1; 

} 


// Try to convert the input arguments to numbers. This 
// an exception if the argument is not a number. 

// num = int.Parse(args[0]); 

int num; 

bool test = int.TryParse(args[0], out num); 

if (test == false) 

{ 


System.Console.WriteLine("Please enter a numeric ar 
System.Console.WriteLine("Usage: Factorial &lt;numé 
return 1; 


} 


// Calculate factorial. 
long result = Functions.Factorial(num); 


// Print result. 
if (result == -1) 

System.Console.WriteLine("Input must be &gt;= © anc 
else 

System.Console.WriteLine("The Factorial of {0} is { 


return 0; 


} 


// If 3 is entered on command line, the 
// output reads: The factorial of 3 is 6. 





后 导航 到 包含 您 风 创 Fes E, 
3. 若 要 编译 应 用 程序 ， 请 输入 下 面 的 命令 。 


csc Factorial.cs 


如 果 您 的 应 用 程序 中 有 没有 编译 错误 ， 则 将 创建 名 为 Factorial.exe 的 可 执行 文 
件 。 


4. 输入 以 下 命令 来 计算 3 的 阶乘 : 

Factorial 3 
5. 此 命令 将 生成 以 下 输出 : The factorial of 3 is 6. 
8 注意 


在 Visual Studio 中 运行 应 用 程序 时 ， 可 以 在 “项 目 设 计 器 ”->“ 调 试 " 页 中 指定 命 命 
行 参 数 。 


有 关 如 何 使 用 命令 行 参数 的 更 多 示例 ， 请 参见 如 何 : 使 用 命令 行 创 建 和 使 用 程序 集 
(C# 和 Visual Basic) 。 


青 参 阅 
System.Environment 


C# 编程 指南 


MSDN C# 编程 指南 & 参考 手册 2015 


Main() 和 命令 行 参数 (CH 编程 指南 ) 

如 何 : 显示 命令 行 参数 (CH 编程 指南 ) 

如 何 : 使 用 foreach 访问 命令 行 参 数 (C# 编程 指南 ) 
Main() 返回 值 (C# 编程 指南 ) 

X (C# 编程 指南 ) 


命令 行 参 数 (CH 编程 指南 ) 419 


如 何 : J 参数 (CH 编程 指南 ) 


可 以 通过 Main 的 可 选 参数 来 访问 通过 命令 行 提 供给 可 执行 文件 的 参数 。 参 数 以 字 
符 串 数组 的 形式 提供 。 数 组 的 每 个 元 素 都 包含 一 个 参数 。 参 数 之 间 的 空白 被 移 除 。 
例如 ， 下 面 是 对 一 个 假想 的 可 执行 文件 的 命令 行 调用 : 


命令 行 输入 传递 给 Main 的 字符 串 数组 
executable.exe ab c "a""b"“c” 
executable.exe one two "one""two" 
executable.exe "one two" three "one two""three" 
8 注意 


在 Visual Studio 中 运行 应 用 程序 时 ， 可 以 在 “项 目 设 计 器 ”->“ 调 试 " 页 中 指定 命 命 
行 参 数 。 


本 示例 显示 了 传递 给 命令 行 应 用 程序 的 命令 行 参 数 。 显 示 的 输出 对 应 于 上 表 中 的 第 
一 项 。 


class CommandLine 


{ 

static void Main(string[] args) 

{ 
// The Length property provides the number of array element 
System.Console.WriteLine("parameter count = {0}", args.Lent 
for (int i = 0; i « args.Length; i++) 

System.Console.WriteLine("Arg[{0}] = [{1}]", i, args[i. 

} 

} 


/* Output (assumes 3 cmd line args): 
parameter count = 3 


Arg[0] = [a] 
Arg[1] = [b] 
Arg[2] = [c] 





请 参阅 


C# 编程 指南 


MSDN C# 编程 指南 & 参考 手册 2015 


Command-ine Building With csc.exe 

Main() 和 命令 行 参 数 (CH 编程 指南 ) 

如 何 : 使 用 foreach 访问 命令 行 参 数 (C# 编程 指南 ) 
Main() 返回 值 (Cf 编程 指南 ) 


如 何 : 显示 命令 行 参 数 (CH 编程 指南 ) 
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如 何 : 使 用 foreach 访问 命令 行 参 数 (CH 编程 指 
南 ) 


循环 访问 数组 的 另 一 种 方法 是 使 用 foreach 语句 ， 如 下 面 的 示例 所 示 。 foreach 语 
句 可 以 用 于 循环 访问 数组 、.NET Framework 集合 类 或 任何 实现 IEnumerable 接口 
的 类 或 结构 。 


== 
Ef TERR 


f£ Visual Studio 中 运行 应 用 程序 时 ， 可 以 在 “项 目 设计 器 ”->“ 调 试 " 页 中 指定 命 命 
行 参 数 。 


S 


下 面 的 示例 演示 如 何 使 用 foreach 输出 命令 行 参 数 。 


// arguments: John Paul Mary 


class CommandLine2 


( 


static void Main(string[] args) 


{ 


System.Console.WriteLine("Number of command line parameter: 


foreach (string s in args) 


E 
} 


System.Console.WriteLine(s); 


j 


J 

/* Output: 
Number of command line parameters = 3 
John 
Paul 


Mary 





Array 
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Command-line Building With csc.exe 

Cft 编程 指南 

foreach, in (C# 参考 ) 

Main() 和 命令 行 参数 (CH 编程 指南 ) 

如 何 : 显示 命令 行 参 数 (CH 编程 指南 ) 
Main() 返回 值 (C# 编程 指南 ) 


如 何 : 使 用 foreach 访问 命令 行 参 数 (CH 编程 指南 ) 423 


Main() 返回 值 (CX 编程 指责) 
Main 方法 可 以 返回 void : 


static void Main() 


{ 
} 


VU 


它 还 可 以 返回 int : 
static int Main() 


OA 
return 0; 


如 果 不 使 用 Main 的 返回 值 ， 则 返回 void 可 以 稍微 简化 代码 。 但 是 ， 如 果 返 回 整 
数 ， 则 程序 可 以 与 调用 该 可 执行 文件 的 其 他 程序 或 脚本 交流 状态 信息 。 下 面 的 示例 
演示 如 何 访问 Main 的 返回 值 。 


此 示例 使 用 一 个 批 处 理 文件 来 运行 程序 ， 并 测试 Main HAPRO. TE Windows 
中 执行 程序 时 ，Main 函数 返回 的 任何 值 都 将 存储 在 名 为 ERRORLEVEL 的 环境 变 
量 中 。 通 过 检查 ERRORLEVEL 变量 ， 批 义理 文件 可 以 确定 执行 结果 。 通 常 ， 返 回 
值 为 需 指 示 执 行 成 功 。 下 面 是 一 个 简单 程序 示例 ， 从 Main KAROS., SERRE 
序 成 功 运行 。 请 将 该 程序 保存 为 MainReturnValTest.cs。 


// Save this program as MainReturnValTest.cs. 
class MainReturnValTest 


static int Main() 


A RE 
return 0; 


Hoz ose FH T Hb BUE, Am ee pe Pet. i&f&BRHOWw to: 
Set Environment Variables for the Visual Studio Command LineFRB 3t BH & AMRS 
行 生 成 ， 或 者 使 用 Visual Studio 命令 提示 (可 通过 “开始 ”菜单 中 的 “Visual Studio 
Tools” 访 问 ) 。 在 命令 提示 符 下 ， 定 位 到 保存 程序 的 文件 夹 。 下 面 的 命令 编译 
MainReturnValTest.cs， 生 成 可 执行 文件 MainReturnValTest.exe。 


csc MainReturnValTest.cs 


接 下 来 ， 创 建 一 个 批 处 理 文件 ， 运 行 MainReturnValTest.exe 并 显示 结果 。 将 下 面 
的 代码 粘贴 到 文本 文件 中 ， 将 该 文件 另存 为 test.bat， 保 存 到 包含 
MainReturnValTest.cs 和 MainReturnValTest.exe 的 文件 夹 中 。 在 命令 提示 符 下 ， 
键入 test， 运行 该 批 处 理 文 件 。 


因为 代码 返回 需 ， 所 以 该 批 处 理 文件 会 报告 成 功 。 但 是 ， 如 果 将 
MainReturnValTest.cs 更 改 为 返回 非 需 值 ， 然 后 重新 编译 程序 ， 则 批 处 理 文件 的 后 
续 执行 将 报告 失败 。 


rem test.bat 
Qecho off 
MainReturnValTest 
Qif "%ERRORLEVEL%" == "OQ" goto good 
:fail 
echo Execution Failed 
echo return value = %ERRORLEVEL% 
goto end 


:good 
echo Execution succeeded 
echo Return value = %ERRORLEVEL% 
goto end 


:end 


示例 输出 


Execution succeeded 


Return value = 0 


请 参阅 

C# 编程 指南 

C# 参考 

Main() 和 命令 行 参数 (CH 编程 指南 ) 

如 何 : 显示 命令 行 参 数 (CH 编程 指南 ) 

如 何 : 使 用 foreach 访问 命令 行 参数 (CH 编程 指南 ) 


命名 空间 (CH 编程 指南 ) 


使 用 C# 编程 时 ， 通 过 两 种 方式 来 大 量 使 用 命名 空间 。 首 先 ，.NET Framework 使 
用 命名 空间 来 组 织 它 的 众多 类 ， 如 下 所 示 : 


System.Console.WriteLine("Hello World!"); 


System 是 一 个 命名 空间 ，Console 是 该 命名 空间 中 的 类 。 可 以 使 用 using 关键 
字 ， 因 此 不 必 使 用 完整 的 名 称 ， 如 以 下 示例 所 示 : 


using System; 


Console.WriteLine("Hello"); 
Console.WriteLine("World!"); 


有 关 更 多 信息 ， 请 参见 using faa (C# 参考 ) 。 


其 次 ， 在 较 大 的 编程 项 目 中 ， 声 明 自己 的 命名 空间 可 以 帮助 控制 类 名 称 和 方法 名 称 
的 范围 。 使 用 namespace 关键 字 可 声明 命名 空间 ， 如 下 例 所 示 : 


namespace SampleNamespace 


{ 
class SampleClass 
public void SampleMethod() 
{ 
System.Console.WriteLine( 
"SampleMethod inside SampleNamespace"); 
} 
} 
} 


命名 空间 概述 
命名 空间 具有 以 下 属性 : 
e 组 织 大 型 代码 项 目 。 
e 使 用 . 运算 符 将 它们 分 陋 。 


e using directive 不 必 为 每 个 类 指定 命名 空间 的 名 称 。 


e global 命名 空间 是 “ 根 " 命 名 空间 : global::System 始终 引用 .NET Framework 
命名 空间 System。 


相关 章节 


有 关 命 名 空间 的 更 多 信息 ， 请 参见 下 列 主题 : 
e 使 用 命名 空间 (C# 编程 指南 ) 
e 如 何 : 使 用 全 局 命名 空间 别名 (CH 编程 指南 ) 
e 如 何 : 使 用 My 命名 空间 (CH 编程 指南 ) 


Ci 语言 规范 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规 范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 编程 指南 

命名 空间 关键 字 (C# 参考 ) 
using faa (CH 参考 ) 

:: 运算 符 (CR 参考 ) 
.运算 符 (CR 参考 ) 


使 用 命名 空间 (CH 编程 指南 ) 


在 C# 程序 中 ， 通 过 两 种 方式 来 大 量 使 用 命名 空间 。 首 先 ，.NET Framework 类 使 
用 命名 空间 来 组 织 它 的 众多 类 。 其 次 ， 在 较 大 的 编程 项 目 中 ， 声 明 自 己 的 命名 空间 
可 以 帮助 控制 类 和 方法 名 的 范围 。 


访问 命名 空间 


大 多 数 C# 应 用 程序 从 一 个 using 指 
命名 空间 ， 避 人 免 程 序 员 在 每 次 使 用 其 


例如 ， 通 过 在 程序 开头 包括 行 : 


开始 。 该 节 列 出 应 用 程序 将 会 频繁 使 用 的 
= 


T 
中 包含 的 方法 时 都 要 指定 完全 限定 的 名 称 。 


using System; 


程序 员 可 以 使 用 代码 : 


Console.WriteLine("Hello, World!"); 


而 不 是 : 


System.Console.WriteLine("Hello, World!"); 


fp 44 Z2 jg 别名 


using 指令 (CH 参考 ) 还 可 用 于 创建 命名 空间 的 别名 。 例 如 ， 如 果 使 用 包含 谋 套 命 
名 空间 的 以 前 编写 的 命名 空间 ， 您 可 能 希望 声明 一 个 别名 来 提供 引用 特定 命名 空间 
的 简写 方法 ， 如 以 下 示例 中 所 示 : 


using Co = Company.Proj.Nested; // define an alias to represent a 


(58 FA p 5 Ze jg RZ bz 


namespace 关键 字 用 于 声明 一 个 范围 。 在 项 目 中 创建 范围 的 能 力 有 助 于 组 织 代 
码 ， 并 可 让 您 创建 全 局 唯一 的 类 型 。 在 下 面 的 示例 中 ， 名 为 SampleClass 的 类 在 
两 个 命名 空间 中 定义 ， 其 中 一 个 命名 空间 嵌 套 在 另 一 个 之 内 。 . 运算 符 (CHES) 
用 于 区 分 所 调用 的 方法 。 





namespace SampleNamespace 


{ 
class SampleClass 
{ 
public void SampleMethod() 
{ 
System.Console.WriteLine( 
"SampleMethod inside SampleNamespace"); 
} 
} 
// Create a nested namespace, and define another class. 
namespace NestedNamespace 
{ 
class SampleClass 
{ 
public void SampleMethod() 
{ 
System.Console.WriteLine( 
"SampleMethod inside NestedNamespace"); 
} 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
// Displays "SampleMethod inside SampleNamespace." 
SampleClass outer = new SampleClass(); 
outer.SampleMethod(); 
// Displays "SampleMethod inside SampleNamespace." 
SampleNamespace.SampleClass outer2 = new SampleNamespac 
outer2.SampleMethod(); 
// Displays "SampleMethod inside NestedNamespace." 
NestedNamespace.SampleClass inner = new NestedNamespace 
inner.SampleMethod(); 
} 
} 
} 





完全 限定 名 


命名 空间 和 类 型 的 名 称 必 须 唯 一 ， 由 指示 逮 辑 层次 结构 的 完全 限定 名 描述 。 例 如 ， 
语句 A.B 表示 A 是 命名 空间 或 类 型 的 名 称 ， 而 B URERA, 


FSI ECEBUX TIAE. ESTA, PETEREAEAL 
namespace N1 // N1 
class C1 // N1.C1 
class C2 Le NACL o2 
j 
namespace N2 // N1.N2 


class C2 // N1.N2.C2 


j 


在 以 上 代码 段 中 : 
e 命名 空间 N1 是 全 局 命名 空间 的 成 员 。 它 的 完全 限定 名 是 N1。 
e 命名 空间 N2 是 命名 空间 N1 的 成 员 。 它 的 完全 限定 名 是 N1.N2。 
e X C1 是 N1 的 成 员 。 它 的 完全 限定 名 是 N1.C1。 


e 在 此 代码 中 使 用 了 两 次 C2 类 名 。 但 是 ， 完 全 限定 名 是 唯一 的 。 C2 的 第 一 个 
实例 是 在 C1 中 声明 的 ; 因此 ， 其 完全 限定 名 为 : N1.C1.C2。 C2 的 第 二 个 实 
例 是 在 命名 空间 N2 中 声明 的 ; 因此 ， 其 完全 限定 名 为 : N1.N2.C2。 


使 用 以 上 代码 段 ， 可 以 用 以 下 方法 将 新 的 类 成 员 C3 添加 到 命名 空间 N1.N2 内 : 


namespace N1.N2 


class C3 // N1.N2.C3 


} 


一 般 情况 下 ， 应 使 用 :: 来 引用 命名 空间 别名 或 使 用 global:: 来 引用 全 局 命名 空间 ， 
并 使 用 . 来 限定 类 型 或 成 员 。 


与 引用 类 型 而 不 是 命名 空间 的 别名 一 起 使 用 :: 是 错误 的 。 例 如 : 


using Alias = System.Console; 


class TestClass 


{ 
static void Main() 
{ 
// Error 
//Alias::WriteLine("Hi"); 
// OK 
Alias.WriteLine("Hi"); 
} 
} 


记 住 单词 global 不 是 预定 义 的 别名 ， 因 此 global.X 没有 任何 特殊 的 含义 。 信 当 与 
:: 一 起 使 用 时 ， 它 才 获 得 特殊 的 含义 。 


定义 名 为 global 的 别名 会 生成 编译 器 警告 CS0440， 因 为 global:: 始终 引用 全 局 命 
空间 而 不 是 别名 。 例 如 ， 下 面 的 行将 产生 警告 : 


using global = System.Collections; // Warning 


最 好 将 :: 与 别名 一 起 使 用 ， 这 样 可 以 避免 意外 引入 其 他 类 型 。 以 下 面 的 代码 为 例 : 


using Alias = System; 


namespace Library 


{ 
} 


public class C : Alias.Exception { } 


这 样 做 可 行 ， 但 是 如 果 接 着 引入 一 个 名 为 Alias 的 类 型 ， 则 Alias. 将 改 为 绑 定 到 该 
类 型 。 使 用 Alias::Exception 可 以 确保 Alias 被 当 作 命 名 空间 别名 ， 而 不 会 被 误 认 为 


c E 别名 的 更 多 信息 ， 请 参见 主题 如 何 : 使 用 全 局 命名 空间 别名 (CH 编程 
HEA) o 


请 参阅 


C# 编程 指南 
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命名 空间 关键 字 (CH 参考 ) 
.运算 符 (CH 参考 ) 
:运算 符 (CH 参考 ) 

extern (C# 参考 ) 


使 用 命名 空间 (CH 编程 指南 ) 
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如 何 : 使 用 全 局 命名 空间 别名 (CH 编程 指南 ) 


当成 员 可 能 被 同名 的 其 他 实体 隐藏 时 ， 能 够 访问 全 局 命名 空间 中 的 成 员 非 常 有 用 。 


例如 ， 在 下 面 的 代码 中 ，Console 在 System 命名 空间 中 解析 为 TestApp.Console 
而 不 是 Console 类 型 。 


using System; 


class TestApp 
{ 
// Define a new class called 'System' to cause problems. 
public class System { } 


// Define a constant called 'Console' to cause more problems. 
const int Console = 7; 
const int number = 66; 


static void Main() 
// The following line causes an error. It accesses TestApp 


// which is a constant. 
//Console.WriteLine(number); 





由 于 类 TestApp.System 隐藏 了 System 命名 空间 ， 因 此 使 用 System.Console 1/7 
然 会 导致 错误 : 


// The following line causes an error. It accesses TestApp.System, 
// which does not have a Console.WriteLine method. 
System.Console.WriteLine(number); 


Bp — ——————————— —eneaÍÜ— ei 


但 是 ， 可 以 通过 使 用 global::System.Console 避免 这 一 错误 ， 如 下 所 示 : 


// OK 
global::System.Console.WriteLine(number); 


当 左 侧 的 标识 符 为 global 时 ， 对 右 侧 标 识 符 的 搜索 将 从 全 局 命名 空间 开始 。 例 
如 ， 下 面 的 声明 将 TestApp 作为 全 局 空间 的 一 个 成 员 进 行 引 用 。 


class TestClass : global::TestApp 


显然 ， 并 不 推荐 创建 自己 的 名 为 System 的 命名 空间 ， 您 不 可 能 遇 到 出 现 此 情况 的 
任何 代码 。 但 是 ， 在 较 大 的 项 目 中 ， 很 有 可 能 在 一 个 窗 体 或 其 他 窗 体 中 出 现 命名 空 
间 重 复 。 在 这 种 情况 下 ， 全 局 命名 空间 限定 符 可 保证 您 可 以 指定 根 命名 空间 。 


在 此 示例 中 ， 命 名 空间 System 用 于 包括 类 TestClass， 因 此 必须 使 用 
global::System.Console 来 引用 System.Console 类 ， 该 类 被 System 命名 空间 隐 
藏 。 而 且 ， 别 名 colAlias 用 于 引用 命名 空间 System.Collections ; Atb, HEA 
此 别名 而 不 是 命名 空间 来 创建 System.Collections.Hashtable 的 实例 。 


using colAlias = System.Collections; 
namespace System 


{ 
class TestClass 
{ 
static void Main() 
{ 
// Searching the alias: 
colAlias::Hashtable test = new colAlias::Hashtable(); 
// Add items to the table. 
test.Add("A", "1"); 
test.Add("B", "2"); 
test.Add("C", "3"); 
foreach (string name in test.Keys) 
// Searching the global namespace: 
global::System.Console.WriteLine(name + " " + test| 
} 
} 
} 
} 





C 编程 指南 


MSDN C# 编程 指南 & 参考 手册 2015 


命名 空间 (CH 编程 指南 ) 
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:: 运算 符 (CHA) 
extern (C# 参考 ) 
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如 何 : 使 用 My 命名 空间 (CH 编程 指 两 ) 


Microsoft.VisualBasic.MyServices 命名 空间 (Visual Basic 中 的 My) 提供 d 
.NET Framework 类 的 简单 直观 的 访问 ， 使 您 能 够 编写 可 与 计算 机 、 应 用 程序 、 

置 、 资 源 等 交互 的 代码 。 虽 然 MyServices 命名 空间 最 初 是 为 使 用 Visual Basic n 
设计 的 ， 但 它 也 可 以 在 CH 应 用 程序 中 使 用 。 


有 关 在 Visual Basic 中 使 用 MyServices 命名 空间 的 更 多 信息 ， 请 参见 使 用 My 开 
发 (Visual Basic)。 


添加 引用 
在 解决 方案 中 使 用 MyServices 类 之 前 ， 必 须 添加 一 个 对 Visual Basic 库 的 引用 。 


添加 对 Visual Basic 库 的 引用 


1. 在 “解决 方案 资源 管理 器 ”中 右 击 “ 引 用 ”节点 ， 再 选择 “添加 引用 ”。 
2. 出 现 汪 | 用 ”对 话 杠 后， 向 下 滚动 列表 ， 选 择 “Microsoft.VisualBasic.dll"。 
您 可 能 还 需要 在 程序 开头 的 using 节 中 包括 以 下 行 。 


using Microsoft.VisualBasic.Devices; 


此 示例 调用 MyServices 命名 空间 中 包含 的 各 种 静态 方法 。 要 编译 此 代码 ， 必 须 在 
项 目 中 添加 一 个 对 Microsoft.VisualBasic.DLL 的 引用 。 


using System; 
using Microsoft.VisualBasic.Devices; 


class TestMyServices 
{ 
static void Main() 
{ 
// Play a sound with the Audio class: 
Audio myAudio = new Audio(); 
Console.WriteLine("Playing sound..."); 
myAudio.Play(@"c:\WINDOWS\Media\chimes.wav"); 


// Display time information with the Clock class: 
Clock myClock = new Clock(); 
Console.Write("Current day of the week: "); 
Console.WriteLine(myClock.LocalTime.DayOfWeek); 
Console.Write("Current date and time: "); 
Console.WriteLine(myClock.LocalTime); 


// Display machine information with the Computer class: 
Computer myComputer - new Computer(); 
Console.WriteLine("Computer name: " + myComputer.Name); 


if (myComputer.Network.IsAvailable) 


Console.WriteLine("Computer is connected to network."), 


j 


else 


{ 


Console.WriteLine("Computer is not connected to networl 





并 不 是 MyServices 命名 空间 中 的 所 有 的 类 都 可 以 从 CH 应 用 程序 调用 : 例如 
FileSystemProxy 类 就 不 兼容 。 在 这 种 特定 情况 下 ， 可 以 改 用 作为 FileSystem (6 
也 包含 在 VisualBasic.dll 中 ) 的 一 部 分 的 静态 方法 。 例 如 ， 下 面 介 绍 了 如 何 使 用 这 
样 的 方法 来 复制 目录 : 


// Duplicate a directory 

Microsoft.VisualBasic.FileIO.FileSystem.CopyDirectory( 
Q"C:Noriginal directory", 
Q"C:Ncopy. of original directory"); 


Es 
R 


y 
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可 以 为 null 的 类 型 (CE 编程 指南 ) 


可 以 为 null 的 类 型 是 System.Nullable<T> 结构 的 实例 。 可 以 为 null 的 类 型 可 以 表 
示 其 基础 值 类 型 正常 范围 内 的 值 ， 再 加 上 一 个 null 值 。 例 如 ，Nullable<lnt32> ix 
作 “ 可 以 为 null 的 Int32?， 可 以 将 其 赋值 为 -2147483648 到 2147483647 之 间 的 任 
意 值 ， 也 可 以 将 其 赋值 为 null 值 。 可 以 赋 给 Nullable<bool> 的 值 包 括 true, false 
或 null。 在 义理 数据 库 和 其 他 包含 不 可 赋值 的 元 素 的 数据 类 型 时 ， 将 null 赋值 给 数 

类 型 或 布尔 型 的 功能 特别 有 用 。 例 如 ， 数 据 库 中 的 布尔 型 字段 可 以 存储 值 true 
或 false， 或 者 ， 该 字段 也 可 以 未 定义 。 


class NullableExample 
{ 


static void Main() 


{ 


int? num = null; 


// Is the HasValue property true? 
if (num.HasValue) 


{ 
} 
else 


{ 
} 


// y is set to zero 
int y = num.GetValueOrDefault(); 


System.Console.WriteLine("num = " + num.Value); 


System.Console.WriteLine("num - Null"); 


// num.Value throws an InvalidOperationException if num.Ha: 
try 
{ 


y = num.Value; 


catch (System. InvalidOperationException e) 


System.Console.WriteLine(e.Message) ; 





此 示例 将 显示 输出 : 


num = Null 


Nullable object must have a value. 


有 关 更 多 示例 ， 请 参见 使 用 可 以 为 null 的 类 型 (C# 编程 指南 ) 。 


可 以 为 null 的 类 型 概述 
可 以 为 null 的 类 型 具有 以 下 特性 : 


e 可 以 为 null 的 类 型 表示 可 被 赋值 为 null 值 的 值 类 型 变量 。 无 法 创建 基于 引用 
类 型 的 可 以 为 null 的 类 型 。 (引用 类 型 已 支持 null 值 。 ) 


语法 T? 是 Nullable<T> 的 简写 ， 此 处 的 T 为 值 类 型 。 这 两 种 形式 可 以 互 换 。 


为 可 以 为 null 的 类 型 赋值 的 方法 与 为 一 般 值 类 型 赋值 的 方法 相同 ， 如 int? x= 
10; 或 double? d = 4.108。 对 于 可 以 为 null 的 类 型 ， 也 可 向 其 赋 null: int? x = 
null. 值 


如 果 基 础 类 型 的 值 为 null， 请 使 用 NullablecT».GetValueOrDefault 方法 返回 
该 基础 类 型 所 赋 的 值 或 黑 认 值 ， 例 如 intj = x.GetValueOrDefault(); 


将 HasValue 和 Value 只 读 属 性 用 于 测试 是 否 为 空 和 检索 值 ， 如 下 面 的 示例 所 
7A : if(x.HasValue) j = x.Value; 


o 如 果 此 变量 包含 值 ， 则 HasValue 属性 返回 true ; 或 者 如 果 是 null 则 返 
回 false。 


如 果 已 赋值 ， 则 Value 属性 返回 该 值 。 否 则 ， 将 引发 
System.InvalidOperationException, 


HasValue 的 默认 值 为 false, Value 属性 没有 默认 值 。 


还 可 以 将 == 和 != 操作 数 用 于 可 为 null 的 类 型 ， 如 下 面 的 示例 所 示 if (x 
l= null) y = x; 


使 用 ?? 算 符 分 配 默认 值 ， 在 将 当前 值 为 null 的 可 以 为 null 的 类 型 赋值 给 不 可 
以 为 null 的 类 型 时 ， 将 应 用 该 默认 值 ， 如 int? x = null; int y = x ?? -1; 


不 允许 使 用 艇 套 的 可 以 为 null 的 类 型 。 将 不 编译 下 面 一 行 : 
Nullable<Nullable<int>> n; 


相关 章节 

有 关 更 多 信息 : 
e 使 用 可 以 为 null 的 类 型 (CH 编程 指南 ) 
e 装 箱 可 以 为 null 的 类 型 (CH 编程 指南 ) 
e ?? 运算 符 (CR 参考 ) 


o 


o 


o 
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有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

Nullable 

C# 编程 指南 

Visual C# 

CHES 

"lifted 正确 意味 着 什么 ? 


可 以 为 null 的 类 型 (C# 编程 指南 ) 441 


使 用 可 以 为 null 的 类 型 (CH 编程 指责) 

可 以 为 null 的 类 型 可 以 表示 基础 类 型 的 所 有 值 ， 另 外 还 可 以 表示 null 值 。 可 以 为 
null 的 类 型 可 通过 下 面 两 种 方式 中 的 一 种 声明 : 

System.Nullable<T> variable 

-或 - 

T?variable 

TT 是 可 以 为 null 的 类 型 的 基础 类 型 。 T 可 以 是 包括 struct 在 内 的 任何 值 类 型 ; 但 
不 能 是 引用 类 型 。 


有 关 可 能 使 用 可 以 为 null 的 类 型 的 示例 ， 请 考虑 普通 的 布尔 变量 如 何 能够 具有 两 个 
值 : true 和 false。 不 存在 表示 “未 定义 ”的 值 。 在 很 多 编程 应 用 中 (最 突出 的 是 数据 
库 交 互 ) ， 变 量 可 以 以 未 定义 的 状态 出 现 。 例 如 ， 数 据 库 中 的 某 个 字段 可 能 包含 值 
true 或 false， 但 是 它 也 可 能 根本 不 包含 值 。 同 样 ， 可 以 将 引用 类 型 设置 为 null， 
以 指示 它们 未 初始 化 。 


这 种 不 一 致 会 导致 额外 的 编程 工作 ， 如 使 用 附加 变量 来 存储 状态 信息 、 使 用 特殊 
值 ， 等 等 。 可 以 为 null 的 类 型 修饰 符 使 C# 能 够 创建 表示 未 定义 值 的 值 类 型 变量 。 


可 以 为 null 的 类 型 示例 
任何 值 类 型 都 可 用 作 可 以 为 null 的 类 型 的 基础 。 例 如 : 


int? i = 10; 

double? di = 3.14; 

bool? flag - null; 

char? letter - 'a'; 

int?[] arr = new int?[10]; 


可 以 为 null 的 类 型 的 成 员 


可 以 为 null 的 类 型 的 每 个 实例 都 具有 两 个 公共 的 只 读 属性 : 
e HasValue 
HasValue 属于 bool 类 型 。 当 变量 包含 非 null 值 时 ， 它 被 设置 为 true。 
e Value 


Value 的 类 型 与 基础 类 型 相同 。 如 果 HasValue 为 true， 则 说 明 Value 包含 有 
意义 的 值 。 如 果 HasValue 为 false， 则 访问 Value 将 引发 
InvalidOperationException. 


在 此 示例 中 ，HasValue 成 员 用 于 在 尝试 显示 变量 之 前 测试 它 是 否 包 含 值 。 


int? x = 10; 
if (x.HasValue) 


1 
System.Console.WriteLine(x.Value); 
} 
else 
System.Console.WriteLine("Undefined"); 
} 


也 可 以 如 下 面 的 示例 所 示 对 值 进行 测试 : 


int? y = 10; 
if (y != null) 


{ 
System.Console.WriteLine(y.Value); 
} 
else 
{ 
System.Console.WriteLine("Undefined" ); 
} 


显 式 转换 


可 以 为 null 的 类 型 可 强制 转换 为 常规 类 型 ， 方 法 是 使 用 强制 转换 来 显 式 转换 或 者 通 
过 使 用 Value 属性 来 转换 。 例 如 : 
int? n = null; 


//int mi 
int m2 
int m3 


E mu 5 


如 果 两 种 数据 类 型 之 间 定 义 了 用 户 定义 的 转换 ， 则 同一 转换 也 可 用 于 这 些 数据 类 型 
的 可 以 为 null 的 版 本 。 


-n; // Will not compile. 
(int)n; // Compiles, but will create an exception if n: 
n.Value; // Compiles, but will create an exception if n: 





隐 式 转换 
可 使 用 null 关键 字 将 可 以 为 null 的 类 型 的 变量 设置 为 null， 如 以 下 示例 所 示 : 


int? n1 = null; 


从 普通 类 型 到 可 以 为 null 的 类 型 的 转换 是 隐 式 的 。 


int? n2; 
n2 = 10; // Implicit conversion. 


运算 符 


可 以 为 null 的 类 型 还 可 以 使 用 预定 义 的 一 元 和 二 元 运算 符 ， 以 及 现 有 的 任何 用 户 定 
义 的 值 类 型 运算 符 。 如 果 操 作 数 为 null， 这 些 运算 符 将 产生 一 个 nul 值 ; 否则 运算 
符 将 使 用 包含 的 值 来 计算 结果 。 例 如 : 


int? a - 10; 

int? b - null; 

abt // Increment by 1, now a is 11. 
a=a* 10; // Multiply by 10, now a is 110. 


a + b; // Add b, now a is null. 


在 对 可 以 为 null 的 类 型 执行 比较 时 ， 如 果 其 中 一 个 可 以 为 null 的 类 型 的 值 为 null， 
但 另外 一 个 类 型 的 值 不 为 null， 则 除 != (不 等 于 ) 外 ， 所 有 比较 的 结果 都 将 为 
false。 一 定 不 要 以 为 由 于 一 个 特定 比较 的 结果 为 false， 相 反 的 情况 就 会 为 true, 
在 以 下 示例 中 ，10 不 大 于 、 小 于 或 等 于 null, RA numi != num2 的 计算 结果 为 
true, 


int? num1 = 10; 
int? num2 - null; 
if (numi »- num2) 


{ 
Console.WriteLine("numi is greater than or equal to num2"); 
} 
else 
// This clause is selected, but numi is not less than num2. 
Console.WriteLine("numi >= num2 returned false (but numi < num: 
} 
if (numi < num2) 
{ 
Console.WriteLine("numi is less than num2"); 
} 
else 
// The else clause is selected again, but numi is not greater 1 
// or equal to num2. 
Console.WriteLine("numi « num2 returned false (but numi >= num: 
} 
if (numi != num2) 
// This comparison is true, numi and num2 are not equal. 
Console.WriteLine("Finally, numi != num2 returns true!"); 
} 


// Change the value of numi, so that both numi and num2 are null. 
num1 = null; 
if (numi -- num2) 


// The equality comparison returns true when both operands are 
Console.WriteLine("num1 == num2 returns true when the value of 


/* Output: 
* num1 >= num2 returned false (but numi < num2 also is false) 
* num1 < num2 returned false (but numi >= num2 also is false) 


* Finally, numi !- num2 returns true! 
* numi == num2 returns true when the value of each is null 
z 





如 果 两 个 可 以 为 null 853: 22894835 75 null， 则 其 相等 比较 的 计算 结果 为 true。 


3? 运算 符 


?3 运算 符 定义 在 将 可 以 为 null 的 类 型 分 配给 非 可 以 为 null 的 类 型 时 返回 的 默认 
{Bo 


int? c = null; 


// d = c, unless c is null, in which case d = -1. 
inme d oc 72 1 


此 运算 符 还 可 用 于 多 个 可 以 为 null 的 类 型 。 例 如 : 


int? e - null; 
int? f - null; 
// g =e or f, unless e and f are both null, in which case g = -1. 


int g = e ?? f ?? -1; 


RE -= AA 


bool?type 


bool? 可 以 为 null 的 类 型 可 以 包含 三 个 不 同 的 值 : true, false 和 null, AKAM 
bool? 强制 转换 为 bool 的 信息 ， 请 参见 如 何 : 安全 地 将 bool? 强制 转换 为 
bool (CZ 编程 指南 ) 。 


可 以 为 null 的 布尔 值 类 似 于 SQL 中 使 用 的 布尔 变量 类 型 。 若 要 确保 由 & 和 产生 的 
结果 | BAAS SQL 中 的 三 值 布 尔 类 型 一 致 ， 提 供 了 以 下 预定 义 的 运算 符 : 


bool?operator &(bool?x, bool?y) 
bool?operator |(bool?x, bool?y) 
下 表 中 列 出 了 这 些 运算 符 的 结果 : 
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X y x&y 
true true true 
true false false 
true null null 
false true false 
false false false 
false null false 
null true null 
null false false 
null null null 

请 参阅 


C# 编程 指南 

可 以 为 null 的 类 型 (CH 编程 指南 ) 
装 箱 可 以 为 null 的 类 型 (C# 编程 指南 ) 
可 以 为 Null 的 值 类 型 (Visual Basic) 


使 用 可 以 为 null 的 类 型 (CH 编程 指南 ) 


true 
true 
true 
true 
false 
null 
true 
null 


null 


xly 


447 


RAAS null 的 类 型 (CH 编程 指责) 


基于 可 以 为 null 的 类 型 的 对 象 只 在 该 对 象 为 非 空 时 装 箱 。 如 果 HasValue 为 
false， 则 将 对 象 引 用 赋值 为 null， 而 不 进行 装 箱 。 例 如 : 


bool? b = null; 
object o = b; 
// Now o is null. 


如 果 对 象 非 空 ， 也 就 是 说 ， 如 果 HasValue 为 true， 则 会 发 生 装 箱 过 程 ， 但 只 将 可 
以 为 null 的 对 象 所 基于 的 基础 类 型 装 箱 。 如 果 将 非 空 的 可 以 为 null 的 值 类 型 装 箱 ， 
将 使 值 类 型 本 身 (而 不 是 包装 该 值 类 型 的 System.Nullable<T>) 装 箱 。 例 如 : 


bool? b = false; 
int? i = 44; 

object bBoxed 
object iBoxed 


b; // bBoxed contains a boxed bool. 
i; // iBoxed contains a boxed int. 


对 于 那些 通过 装 箱 非 可 以 为 null 的 类 型 而 创建 的 类 型 来 说 ， 两 种 装 箱 对 象 是 完全 相 
同 的 。 并 且 ， 像 非 可 以 为 null 的 装 箱 类 型 一 样 ， 可 以 将 它们 取消 装 箱 ， 使 其 成 为 可 
以 为 null 的 类 型 ， 如 以 下 示例 所 示 : 


bool? b2 = (bool?)bBoxed; 
int? i2 = (int?)iBoxed; 


备注 
可 以 为 null 的 类 型 在 装 箱 时 的 行为 具有 两 个 优点 : 


1. 可 以 测试 可 以 为 null 的 对 象 及 其 装 箱 的 对 应 项 是 否 为 空 : 


bool? b = null; 
object boxedB - b; 
if (b == null) 

// True. 
} 
if (boxedB == null) 


// Also true. 
} 


2. 装 箱 的 可 以 为 null 的 类 型 完全 支持 基础 类 型 的 功能 : 


double? d = 44.4; 

object iBoxed = d; 

// Access IConvertible interface implemented by double. 
IConvertible ic - (IConvertible)iBoxed; 

int i = ic.ToInt32(null); 

string str = ic.ToString(); 


`> 主 - 
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可 以 为 null 的 类 型 (CH 编程 指南 ) 

如 何 : 标识 可 以 为 null 的 类 型 (CH 编程 指南 ) 


如 何 : 标识 可 以 为 null 的 类 型 (CH 编程 指南 ) 
可 以 使 用 C# typeof 运算 符 来 创建 表示 可 以 为 null 的 类 型 的 Type 对 象 : 


System.Type type = typeof(int?); 


还 可 以 使 用 System.Reflection 命名 空间 的 类 和 方法 来 生成 表示 可 以 为 null 的 类 型 
的 Type 对 象 。 但 是 ， 如 果 您 尝试 使 用 GetType 方法 或 is 运算 符 在 运行 时 获得 可 
以 为 null 的 类 型 变量 的 类 型 信息 ， 得 到 的 结果 是 表示 基础 类 型 而 不 是 可 以 为 null 的 
类 型 本 身 的 Type 对 象 。 


如 果 对 可 以 为 null 的 类 型 调用 GetType， 则 在 该 类 型 被 隐 式 转换 为 Object 时 将 执 
行 装 箱 操作 。 因 此 ，GetType 总 是 返回 表示 基础 类 型 而 不 是 可 以 为 null 的 类 型 的 
Type 对 象 。 


int? i 
Type t GetType(); 
Console.WriteLine(t.FullName); //"System.Int32" 


5; 
qe 


CH 的 is 运算 符 还 可 以 作用 于 可 以 为 null 的 的 基础 类 型 。 因 此 ， 不 能 使 用 is 来 确定 
变量 是 否 为 可 以 为 null 的 类 型 。 下 面 的 示例 演示 is 运算 符 将 Nullable<int> 变量 视 
为 int 变量 。 


static void Main(string[] args) 
1 
int? i = 5; 
if (i is int) // true 
Ub 


使 用 下 面 的 代码 来 确定 Type 对 象 是 否 表示 可 以 为 null 的 类 型 。 请 记 住 ， 如 果 Type 
对 象 是 通过 调用 GetType 返回 的 ， 则 此 代码 始终 返回 false， 如 本 主题 中 先前 所 


if (type.IsGenericType && type.GetGenericTypeDefinition() == typeo! 





请 参阅 
可 以 为 null 的 类 型 (CH 编程 指南 ) 
装 箱 可 以 为 null 的 类 型 (C# 编程 指南 ) 
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如 何 : 标识 可 以 为 null 的 类 型 (CH 编程 指南 ) 451 


如 何 : 安全 地 将 bool? 强制 转换 为 bool (CH 编程 
IHRE) 
bool? 可 以 为 null 的 类 型 可 以 包含 三 个 不 同 的 值 true, false 和 null, 


it, bool? 类 型 不 能 用 于 条 件 语句 ， 如 计 for 或 while。 例 如 ， 以 下 代码 会 导致 编 
译 二 错误 。 


bool? b = null; 
if (b) // Error CS0266. 


j 


这 是 不 允许 的 ， 因 为 null 在 条 件 上 下 文中 的 含义 并 不 清楚 。 若 要 在 条 件 语 句 中 使 用 
bool?， 请 首先 检查 其 biens 属性 以 确保 其 值 不 是 null， 然 后 将 它 强制 转换 为 
bool。 有 关 更 多 信息 ， 请 参见 bool。 如 果 对 使 用 null (& 5 bool? 执行 强制 转换 ， 
则 在 条 件 测 试 中 将 引发 InvalidOperationException。 下 面 的 示例 演示 了 一 种 从 
bool? 安全 地 强制 转换 为 bool 的 方法 : 


bool? test = null; 
// Other code that may or may not 
// give a value to test. 
if(!test.HasValue) //check for a value 
// Assume that IsInitialized 
// returns either true or false. 
test - IsInitialized(); 
if((bool)test) //now this cast is safe 


// Do something. 


请 参阅 
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文字 关键 字 (C# 参考 ) 

可 以 为 null 的 类 型 (CH 编程 指南 ) 
?? AAT (CH 参考 ) 


语句 、 表 达 陈 和 运算 符 (CH 编程 指 雨 ) 
构成 应 用 程序 的 C# 代码 由 包含 关键 字 、 表 达 式 和 运算 符 的 语句 组 成 。 本 节 包 含 关 
于 C# 程序 的 基本 元 素 的 信息 。 
有 关 更 多 信息 ， 请 参见 : 
e 语句 (CH 编程 指南 ) 
。 表 达 式 (CH 编程 指南 ) 
e 运算 符 (CH 编程 指南 ) 
e EE ERA (CH 编程 指南 ) 
e 可 重 载运 算 符 (CH 编程 指南 ) 
e 转换 运算 符 (CH 编程 指南 ) 
o 使 用 转换 运算 符 (CH 编程 指南 ) 
o 如 何 : 在 结构 间 实 现 用 户 定义 的 转换 〈C# 编程 指南 ) 
e 如 何 : 使 用 运算 符 重 载 创建 复数 类 (CH 编程 指南 ) 
e 相等 比较 (CH 编程 指南 ) 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 
C# 编程 指南 
强制 转换 和 类 型 转换 (CH 编程 指南 ) 


语句 (CH 编程 指南 ) 


程序 所 执行 的 操作 以 “语句 "表达 。 常 见 操作 包括 声明 变量 、 赋 值 、 调 用 方法 、 循 环 
访问 集合 ， 以 及 根据 给 定 条 件 分 支 到 一 个 或 另 一 个 代码 块 。 语 名 在 程序 中 的 执行 顺 
序 称 为 "控制 流 ?” 或 “执行 流 ”。 根 据 程序 对 运行 时 所 收 到 的 输入 的 响应 ， 在 程序 每 次 运 
行 时 控制 流 可 能 有 所 不 同 。 

语句 可 以 是 以 分 号 结尾 的 单行 代码 ， 或 者 是 语句 块 中 的 一 系列 单行 语句 。 语 句 块 括 
在 括号 人 } 中 ， 并 且 可 以 包含 馈 套 块 。 下 面 的 代码 演示 两 个 单行 语句 示例 和 一 个 多 行 
语句 块 : 


static void Main() 

{ 
// Declaration statement. 
int counter; 


// Assignment statement. 
counter = 1; 


// Error! This is an expression, not an expression statemer 
// counter + 1; 


// Declaration statements with initializers are functional. 
// equivalent to declaration statement followed by assignr 
int[] radii = { 15, 32, 108, 74, 9 }; // Declare and initi: 
const double pi - 3.14159; // Declare and initialize cons! 


// foreach statement block that contains multiple statement 
foreach (int radius in radii) 
{ 

// Declaration statement with initializer. 

double circumference = pi * (2 * radius); 


// Expression statement (method invocation). A single-- 
// statement can span multiple text lines because line 
// are treated as white space, which is ignored by the 
System.Console.WriteLine("Radius of circle #{0} is {1} 

counter, radius, circumference: 


// Expression statement (postfix increment). 
counter++; 


) // End of foreach statement block 
) // End of Main method body. 
) // End of SimpleStatements class. 





Vas 
Output: 
Radius of circle #1 = 15\. Circumference = 94.25 
Radius of circle #2 = 32\. Circumference = 201.06 
Radius of circle #3 = 108\. Circumference = 678.58 
Radius of circle #4 = 74\. Circumference = 464.96 
Radius of circle #5 = 9\. Circumference = 56.55 
i 
JE EE 
`~ 米 | 
语句 的 类 型 


下 表 列 出 C# 中 的 各 种 语句 类 型 及 其 关联 的 关键 字 ， 并 提供 指向 包含 更 多 信息 的 主 
题 的 链接 : 


x 9| Ci 关键 字 / 说 明 


声明 声明 语句 引入 新 的 变量 或 常量 。 变 量 声明 可 以 选择 为 变量 赋值 。 在 常 
语句 量 声明 中 必须 赋值 。 





// Variable declaration statements. 
double area; 
double radius - 2; 


// Constant declaration statement. 
const double pi - 3.14159; 


表达 式 语 句 用 于 计算 值 的 表达 式 语 句 必须 在 变量 中 存储 该 值 。 


// Expression statement (assignment). 
area = 3.14 * (radius * radius); 


// Error. Not statement because no assignment: 
Y C TEC 


// Expression statement (method invocation). 
System.Console.WriteLine(); 


// Expression statement (new object creation). 
System.Collections.Generic.List&lt;string&gt; strings - 
new System.Collections.Generic.List&lt;string&gt;(); 


选择 语句 用 于 根据 一 个 或 多 个 指定 条 件 分 支 到 不 同 的 代码 段 。 有 关 更 
多 信息 ， 请 参见 下 列 主题 if, else, switch, case 


迭代 语句 用 于 通 历 集合 〈 如 数组 ) ， 或 重复 执行 同一 组 语句 直到 满足 
指定 的 条 件 。 有 关 更 多 信息 ， 请 参见 下 列 主题 do, for, foreach, in, 
while 


跳 转 语句 将 控制 转移 给 另 一 代码 段 。 有 关 更 多 信息 ， 请 参见 下 列 主 
题 : break, continue, default, goto, return, yield 


异常 处 理 语句 用 于 从 运行 时 发 生 的 异常 情况 正常 恢复 。 有 关 更 多 信 
息 ， 请 参见 下 列 主题 throw, try-catch, try-finally, try-catch-finally 


检查 和 未 检查 语句 用 于 指定 当 将 结果 存储 在 变量 中 、 但 该 变量 过 小 而 
不 能 容纳 结果 值 时 ， 是 否 人 允许 数值 运算 导致 浴 出 。 有 关 更 多 信息 ， 请 
参见 检查 和 未 检查 。 


如 果 标 记 与 异步 修饰 符 的 方法 ， 在 方法 可 以 使 用 等 待 运算 符 。 当 控 
件 移 到 在 异步 方法 中 的 一 个 await 表达 式 ， 控 件 回 调用 方 ， 因 此 ， 在 
方法 的 进度 挂 起 ， 直 到 等 竺 任务 完成 。 当 任务 完成 后 ， 执 行 在 方法 可 
以 恢复 。 有 关 简 单 示例 ， 请 参见 AK (CH 编程 指南 ) “Async "75 
法 "一 节 。 有 关 更 多 信息 ， 请 参见 使 用 Async 和 Await 的 异步 编程 
(C# 和 Visual Basic) 。 


迭代 器 对 集合 的 自 定 义 返 代 ， 如 列表 或 数组 。 迭 代 器 使 用 将 返回 话 
句 返 回 每 个 元 素 一 个 节点 。 当 yield return 语句 时 ， 代 码 的 当前 位 置 
确保 。 和 迭代 器 ， 当 下 次 时 ， 调 用 执行 从 该 位 置 进行 重新 和 启动。 有关 更 
多 信息 ， 请 参见 迭代 器 (C# 和 Visual Basic) 。 

Fixed 语句 禁止 垃圾 回收 器 重 定位 可 移动 的 变量 。 有 关 更 多 信息 ， 请 
参见 fixed。 

lock 语句 用 于 限制 一 次 公允 许 一 个 线程 访问 代码 块 。 有 关 更 多 信息 ， 
请 参见 lock. 

可 以 为 语句 指定 一 个 标记 ， 然 后 使 用 goto 关键 字 跳 转 到 该 标记 语 
句 。 (参见 下 一 行 中 的 示例 。) 

空 语句 只 含 一 个 分 号 。 空 语句 不 执行 任何 操作 ， 可 以 在 需要 语句 但 不 
需要 执行 任何 操作 的 地 方 使 用 。 下 面 的 示例 演示 空 语句 的 两 种 用 法 : 


void ProcessMessages() 


while (ProcessMessage()) 
; // Statement needed here. 


j 


void F() 


A 

if (done) goto exit; 
Vi. 
exit: 

; // Statement needed here. 
} 


ERA 


一 些 语句 〈 例 如 do, while, for 和 foreach) 后 面 始终 跟 有 一 条 艇 入 语句 。 此 族人 
语句 可 以 是 单个 语句 ， 也 可 以 是 语句 块 中 括 在 括号 人 } 内 的 多 个 语句 。 甚 至 可 以 在 括 


号 全 内 包含 单行 说 入 滞 句 ， 如 下 面 的 示例 所 示 : 


// Recommended style. Embedded statement in block. 

foreach (string s in System.IO.Directory.GetDirectories( 
System.Environment.CurrentDirectory)) 

{ 


} 


// Not recommended. 
foreach (string s in System.IO.Directory.GetDirectories( 
System.Environment.CurrentDirectory)) 
System.Console.WriteLine(s); 


System.Console.WriteLine(s); 


未 括 在 括号 {} 内 的 嵌入 语句 不 作为 声明 语句 或 标记 语句 。 下 面 的 示例 演示 了 


I8? 


if(pointB -- true) 
//Error CS1023: 
int radius - 5; 


将 该 嵌入 语句 放 在 语句 块 中 以 修复 错误 


这 种 


if (b -- true) 
// OK: 


System.DateTime d - System.DateTime.Now; 
System.Console.WriteLine(d.ToLongDateString()); 


PRE iS ALR 
语句 块 可 以 嵌 套 ， 如 以 下 代码 所 示 : 


foreach (string s in System.IO.Directory.GetDirectories( 
System.Environment.CurrentDirectory)) 


t 
if (s.Startswith("CSharp") ) 
if (s.Endswith("TempFolder") ) 
{ 
return s; 
j 
j 
j 


return "Not found."; 


无 法 访问 的 语句 
如 果 编 译 器 认为 在 任何 情况 下 控制 流 都 无 法 到 达 特 定语 句 ， 将 生成 警告 CS0162， 
如 下 面 的 示例 所 示 : 


// An over-simplified example of unreachable code. 
const int val - 5; 

if (val « 4) 

{ 


} 
PIE 


相关 章节 


e 语句 关键 字 (C# 参考 ) 
e 表达 式 (CH 编程 指南 ) 


System.Console.WriteLine("I'll never write anything."); //CSO1t 





e 2A (CH 编程 指南 ) 
CH 语音 A NE 
有 关 详 细 信 息 ， i8 € $2] C# i Ta 吾 言 规范 。 该 语 eA 
请 参阅 


C# 编程 指南 


是 C# 语 和 吾 法 和 用 法 的 权威 资料 。 


表达 式 (CH 编程 指南 ) 


“表达 式 " 是 由 一 个 或 多 个 操作 数 以 及 需 个 或 震 个 以 上 的 运算 符 所 组 成 的 序列 ， 可 以 
通过 计算 得 到 一 个 值 、 对 象 、 方 法 或 命名 空间 等 结果 。 表 达 式 可 以 包含 文本 值 、 方 
法 调用 、 运 算 符 及 其 操作 数 ， 或 简单 名 称 。 简 单 名 称 可 以 是 变量 、 类 型 成 员 、 方 法 
参数 、 命 名 空间 或 类 型 的 名 称 。 


表达 式 可 以 使 用 运算 符 ， 而 运算 符 又 可 以 将 其 他 表达 式 用 作 参 数 ， 或 者 使 用 方法 调 
用 ， 而 方法 调用 的 参数 又 可 以 是 其 他 方法 调用 ， 因 此 表达 式 既 可 以 非常 简单 ， 也 可 
以 非常 复杂 。 下 面 是 表达 式 的 两 个 示例 : 


(0 
System.Convert.ToInt32("35") 


表达 式 值 


在 大 部 分 使 用 表达 式 的 上 下 文中 ， 例 如 在 语句 或 方法 参数 中 ， 表 达 式 应 计算 为 某 个 
值 。 如 果 x 和 y 是 整数 ， 表 达 式 x + y 将 计算 为 一 个 数值 。 表 达 式 new MyClass() 
计算 为 对 MyClass 对 象 的 新 实例 的 引用 。 表 达 式 myClass.ToString() 计算 为 一 个 字 
符 串 ， 因 为 字符 串 是 该 方法 的 返回 类 型 。 然 而 ， 虽 然 命名 空间 名 称 轨 类 为 表达 式 ， 
但 它 不 计算 为 值 ， 因 此 永远 不 能 作为 任何 表达 式 的 最 终结 果 。 命 名 空间 名 称 不 能 传 
递 给 方法 参数 ， 不 能 用 在 新 表达 式 中 ， 也 不 能 赋值 给 变量 。 命 名 空间 名 称 只 能 用 作 
较 大 表达 式 的 子 表达 式 。 同 样 如 此 的 还 有 类 型 (与 System.Type 对 象 不 同 ) 、 方 法 
组 名 称 (与 特定 方法 不 同 ) 以 及 事件 add 和 remove 访问 器 。 

每 个 值 都 有 关联 的 类 型 。 例 如 ， 如 果 x 和 y 都 是 int 类 型 的 变量 ， 则 表达 式 x+y 
的 值 的 类 型 也 是 int。 如 果 将 该 值 赋 给 不 同类 型 的 变量 ， 或 者 如 果 x y 是 不 同 的 
类 型 ， 则 应 用 类 型 转换 规则 。 有 关 如 何 进行 这 种 转换 的 更 多 信息 ， 请 参见 强制 转换 
和 类 型 转换 (CH 编程 指南 ) o 


i HY 


如 果 值 大 于 值 类 型 的 最 大 值 ， 数 值 表达 式 可 能 导致 浴 出 。 有 关 更 多 信息 ， 请 参见 
Checked 和 Unchecked (CH 参考 ) 和 显 式 数值 转换 表 (CR S), 


运算 符 的 优先 级 和 结合 性 


计算 表达 式 的 方式 由 结合 性 和 运算 符 优 先 级 控制 。 有 关 更 多 信息 ， 请 参见 运算 符 
(C# 编程 指南 ) 。 


除 赋 值 表达 式 和 方法 调用 表达 式 之 外 ， 大 部 分 表达 式 都 必须 和 任 在 语句 中 。 有 关 更 多 
信息 ， 请 参见 语句 (CH 编程 指南 ) 。 


文本 和 简单 名 称 


最 简单 的 两 种 表达 式 类 型 是 文本 和 简单 名 称 。 文 本 是 没有 名 称 的 常数 值 。 例 如 ， 在 
下 面 的 代码 示例 中 ，5 和 "Hello World" 都 是 文本 值 : 


// Expression statements. 
int i = 5; 
string s = "Hello World"; 


有 关 文 本 的 更 多 信息 ， 请 参见 类 型 (C# 参考 ) 。 


在 上 面 的 示例 中 ，i 和 s 都 是 用 于 标识 局 部 变量 的 简单 名 称 。 在 表达 式 中 使 用 这 些 
变量 名 称 计 算 为 当前 在 该 变量 的 内 存 位 置 所 存储 的 值 。 下 面 的 示例 演示 了 
这 种 情况 : 


int num = 5; 

System.Console.WriteLine(num); // Output: 5 
num = 6; 

System.Console.WriteLine(num); // Output: 6 


调用 表达 式 


在 下 面 的 代码 示例 中 ， 对 DoWork 的 调用 是 一 个 调用 表达 式 。 


DoWork(); 


方法 调用 要 求 使 用 方法 的 名 称 《如 前 面 的 示例 中 那样 作为 名 称 ， 或 作为 其 他 表达 式 
的 结果 ) ， 后 跟 括 号 和 任意 方法 参数 。 有 关 更 多 信息 ， 请 参见 方法 (CH 编程 指 
南 ) 。 委 托 调 用 使 用 委托 的 名 称 和 括号 内 的 方法 参数 。 有 关 更 多 信息 ， 请 参见 委托 
(CH 编程 指南 ) 。 如 果 方 法 返回 值 ， 则 方法 调用 和 委托 调用 的 计算 结果 为 该 方法 
的 返回 值 。 返 回 void 的 方法 不 能 替代 表达 式 中 的 值 。 


查询 表达 式 


有 关 常 规 表达 式 的 规则 同样 适用 于 查询 表达 式 。 有 关 更 多 信息 ， 请 参见 LINQ 查询 
表达 式 (CH 编程 指南 ) o 


Lambda 表达 式 


Lambda 表达 式 表 示 没 有 名 称 但 可 以 具有 输入 参数 和 多 个 语句 的 "内 联 方法 "。 它 们 
f£ LINQ 中 广泛 用 于 向 方法 传递 参数 。Lambda 表达 式 被 编译 为 委托 或 表达 式 树 ， 
具体 取决 于 使 用 它们 的 上 下 文 。 有 关 更 多 信息 ， 请 参见 Lambda 表达 式 (CH 编程 


指南 ) 。 


表达 式 树 
使 用 表达 式 树 可 以 将 表达 式 表示 为 数据 结构 。 表 达 式 树 由 LING 提供 程序 广泛 使 


用 ， 用 来 将 查询 表达 式 转 换 为 在 其 他 某 个 上 下 文 (如 SQL 数据 库 ) 中 有 意义 的 代 
码 。 有 关 更 多 信息 ， 请 参见 表达 式 树 (C# 和 Visual Basic) 。 


备注 
只 要 从 表达 式 中 识别 到 变量 、 对 象 属性 或 对 象 索 引 器 访问 ， 该 项 的 值 都 会 用 作 表 这 


式 的 值 。 在 C# 中 ， 只 要 表达 式 的 最 终 计 算 结 果 是 所 需 的 类 型 ， 表 达 式 就 可 以 放置 
在 任何 需要 值 或 对 象 的 位 置 。 


重要 章节 


Variables and Expressions 在 Beginning Visual C# 2010 


请 参阅 

C# 编程 指南 

方法 (CH 编程 指南 ) 

委托 (CH 编程 指南 ) 

zB (CH 编程 指南 ) 

类 型 (CH 编程 指南 ) 

LINQ 查询 表达 式 (CH 编程 指南 ) 


运算 符 (CH 编程 指南 ) 


在 CH 中 ， 运 算 符 是 应 用 于 表达 式 或 语句 中 的 一 个 或 多 个 操作 数 的 程序 元 素 。 接受 
一 个 操作 数 的 运算 符 称 为 一 元 运算 符 ， 例 如 递增 运算 符 (++) 或 new。 接受 两 个 操 
作 数 的 运算 符 称 为 二 元 运算 符 ， 例 如 算术 运算 符 (+、-、*、/) 。 条 件 运算 符 ?: 接 
受 三 个 操作 数 ， 是 C# 中 唯一 的 三 元 运算 符 。 
人 
J 值 。 


yup 


下 面 的 C# 语句 包含 两 个 二 元 运算 符 ， 它 们 分 别 有 两 个 操作 数 。 赋值 运算 符 = 将 一 
个 整数 变量 y 和 一 个 表达 式 2 + 3 作为 操作 数 。 表达 式 2 + 3 本 身 由 加 法 运算 符 和 
两 个 操作 数 2 和 3 组 成 。 


运算 符 、 计 算 和 运算 符 优 先 级 


操作 数 可 以 是 由 任何 关 度 的 代码 组 成 的 有 效 表达 式 ， 且 可 包含 任意 数量 的 子 表达 
X. 在 包含 多 个 运算 竺 的 表达 式 中 ， 芭 算 符 的 应 用 呈 序 由 去 算 符 优先 级 、 关 联 性 和 
舌 号 确定 。 


每 个 运算 符 都 具有 已 定义 的 优先 级 。 在 包含 具有 不 同 优先 级 级 别 的 多 个 运算 符 的 表 
达 式 中 ， 运 算 符 的 优先 级 确定 运算 符 的 计算 顺序 。 例如 ， 下 列 语句 将 3 赋 给 n1。 


n1=11-2*4; 

因为 乘法 的 优先 级 高 于 减法 ， 所 以 首先 执行 乘法 。 

下 表 根 据 运 算 符 执行 的 操作 类 型 将 它们 划分 到 不 同 的 类 别 中 。 类 别 按 优先 级 顺序 列 
出 。 


主要 运算 符 


x EE A aI a Mx yc PR 
MACHAN (^44 po FO to Se Q JR Te no oN 
VIOLI Y LA ZatEIB A €& Soa ZU 


Expression 描述 

X.yx?.y 成 员 访问 条 件 成 员 访问 

f(x) 方法 和 委托 调用 

a[xja?[x] 数组 和 索引 器 访问 条 件数 组 和 索引 器 访问 

Xit 后 递增 

X-- 后 递减 

new T(...) 对 象 和 委托 创建 

new TENA 县 有 初始 值 设 定 项 的 对 象 创建 。 请 参阅 对 象 和 集合 初始 值 设 
定 项 (CH 编程 指南 ) 。 

new (...) 匿名 对 象 初始 值 设 定 项 。 请 参阅 匿名 类 型 (CH 编程 指南 ) 。 

new T[...] 数组 创建 。 请 参阅 数组 (CH 编程 指南 ) 。 

typeof(T) # HX T BY System.Type 对 象 

checked(x) 在 已 检查 的 上 下 文中 计算 表达 式 

unchecked(x) ， 在 未 检查 的 上 下 文中 计算 表达 式 

default (T) 获取 类 型 T 的 默认 值 

delegate {} 匿名 函数 (匿名 方法 ) 

一 元 运算 符 
Expression 描述 

+X Ty 

-X 求 反 

Ix 逻辑 求 反 

~X 按 位 求 反 

TX 前 递增 

E 前 递减 

(T)x Rx 显 式 转换 为 类 型 下 


乘法 运算 符 


Expression 描述 

乘法 

/ 除 号 

% 余数 
相 加 运算 符 

Expression 描述 

x+y KAN], FR BSR. BAG 

X-y 相 减 、 委 托 移 除 
移 位 运算 符 

Expression 描述 

x <<y 左 移 

x >> y 右 移 
关系 和 类 型 运算 符 

Expression 描述 

x<y 小 于 

X xc 

X «2 y 小 于 或 等 于 

x»my AGAT 

xis T 如 果 x 为 T， 则 返回 True ; 否则 返回 False. 

xas T 返回 类 型 为 TT 的 x， 如 果 x 不 是 T， 则 返回 null 
相等 运算 符 

Expression 描述 
X==y 等 于 
xl=y 不 等 于 


逻辑 、 条 件 和 null 运算 符 


类 别 Expression 描述 


T. x &y 整 型 按 位 “与 "， 布 尔 型 逻辑 “与 ” 
en x^y 整 型 按 位 XOR， 布 尔 型 逻辑 XOR 
x|y 整 型 按 位 “或 "， 布 尔 型 逻辑 “或 ” 
条 
件 “ 与 ” x && y 4.24 x 为 True 时 计算 y 
条 
ea” x |l y 4 34 x X False 时 计算 y 
null & o5 er E Emo ye 
3c x ?? y 如 果 x 为 Null， 则 计算 结果 为 y， 否 则 计算 结果 为 X 
条 件 运 | ee 如 果 x 为 True， 则 计算 结果 为 y ; MAR x 为 False 
则 计算 结果 为 z 
赋值 和 匿名 运算 符 
Expression 描述 
- 赋值 
合 赋值 。 zem DAS - 
x OpY =N pa EN oak &=. |=, l=" <<=, >>= 


(Tx) => y 匿名 函数 (lambda 表达 式 ) 


当 表 达 式 中 出 现 两 个 或 两 个 以 上 具有 相同 优先 级 的 运算 符 时 ， 将 根据 结合 性 计算 它 
们 。 左 结合 运算 符 按 从 左 到 右 的 顺序 计算 。 例如 ，x y/z 将 计算 为 (x y)/z。 右 结 
合 运算 符 按 从 右 到 左 的 顺序 计算 。 例如 ， 赋 值 运算 符 是 右 关 联 的 。 如 果 不 是 ， 下 
面 的 代码 将 导致 错误 。 


int a, b, c; c - 1; // The following two lines are equivalent. a = 
spo 0 — RR 
再 举 一 个 例子 ， 三 元 运算 符 (?:) 是 右 结合 运算 符 。 大 多 数 的 二 元 运算 符 是 左 结合 运 
算 


do 





无 论 表 达 式 中 的 运算 符 是 左 结 合 运 算 符 还 是 右 结合 运算 符 ， 都 将 先 从 左 至 右 评估 各 
表达 式 的 操作 数 。 以 下 示例 显示 运算 符 和 操作 数 的 计算 顺序 。 


语句 计算 顺序 
a=b a、 
a=b+c a、 
a=b+c*d a, 
a=b*c+d a, 


a=b-c+d ay 


E CU E CU Bee CU 
o 
* 
a 
T 
1 


at=b-=c ay 


添加 括号 


可 通过 使 用 圆 括号 更 改 运算 符 优 先 级 和 相关 性 。 例如 ，2 + 3 2 通常 计算 结果 为 

8， 因 为 乘法 运算 符 的 优先 级 高 于 加 法 运算 符 。 但 是 ， 如 果 你 将 表达 式 编写 为 (2 + 
3) 2， 则 先 计算 加 法 ， 再 计算 乘法 ， 且 结果 为 10. 以 下 示例 显示 括号 表达 式 中 的 计 
算 顺 序 。 如 前 面 的 示例 中 所 示 ， 计 算 操 作 数 之 前 会 应 用 运算 符 。 


语句 计算 顺序 
a=(b+c)*d ay Dy Cy +、d、*、= 
a=b-(c+d) a, Dy Cy dy ty. = 
a - (b * c) * (d-e) a, batde-. * = 


运算 符 重 载 


对 于 自 定义 类 和 结构 ， 你 可 以 更 改 运算 符 的 行为 。 此 过 程 称 为 “运算 符 重 载 "。 有 关 
更 多 信息 ， 请 参见 可 重 载运 算 符 (C# 编程 指南 ) 。 


相关 章节 
有 关 详 细 信 息 ， 请 参阅 运算 符 关 键 字 (C# 参考 ) 和 C# 运算 符 。 
请 参阅 


C# 编程 指南 
语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 


匿名 函数 (CH 编程 指南 ) 


EAKATE- NAR BORMAN, TEARRE A UBUCEIHBZ RR]. Ae 
FH AER IURIS I dR AS ETC, Newest (而 不 是 命名 委托 类 型 ) 作为 方法 


共有 两 种 匿名 辑 数 ， 以 下 主题 中 分 别 讨论 了 这 些 画 数 : 

e Lambda 表达 式 (CH 编程 指南 ) . 

e 匿名 方法 (CH 编程 指南 ) 

a 注意 

Lambda 表达 式 可 以 绑 定 到 表达 式 树 ， 也 可 以 绑 定 到 委托 。 


Cit 中 委托 的 发 展 


在 C# 1.0 中 ， 您 通过 使 用 在 代码 中 其 他 位 置 定义 的 方法 显 式 初始 化 委托 来 创建 委 
托 的 实例 。C# 2.0 引入 了 匿名 方法 的 概念 ， 作 为 一 种 编写 可 在 委托 调用 中 执行 的 未 
命名 内 联 语句 块 的 方式 。C# 3.0 引入 了 Lambda 表达 式 ， e 
MARU, (BERGXSZITBS NA. RAMADAN A EARR RS. Ho 
.NET Framework 版 本 3.5 及 更 高 版 本 的 应 用 程序 应 使 用 Lambda 表达 式 。 


下 面 的 示例 演示 了 从 CH 1.0 到 C£ 3.0 委托 创建 过 程 的 发 展 : 


class Test 


{ 
delegate void TestDelegate(string s); 
static void M(string s) 
{ 
Console.WriteLine(s); 
} 
static void Main(string[] args) 
{ 
// Original delegate syntax required 
// initialization with a named method. 
TestDelegate testDelA = new TestDelegate(M); 
// C# 2.0: A delegate can be initialized with 
// inline code, called an "anonymous method." This 
// method takes a string as an input parameter. 
TestDelegate testDelB = delegate(string s) { Console.Writel 
// C# 3.0N. A delegate can be initialized with 
// a lambda expression. The lambda also takes a string 
// aS an input parameter (x). The type of x is inferred by 
TestDelegate testDelC = (x) => { Console.WriteLine(x); }; 
// Invoke the delegates. 
testDelA("Hello. My name is M and I write lines."); 
testDelB("That's nothing. I'm anonymous and "); 
testDelC("I'm a famous author."); 
// Keep console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Output: 
Hello. My name is M and I write lines. 
That's nothing. I'm anonymous and 
I'm a famous author. 
Press any key to exit. 
29 





有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 
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语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 
Lambda 表达 式 (CH 编程 指南 ) 

委托 (CH 编程 指南 ) 

表达 式 树 (C# 和 Visual Basic) 


匿名 画 数 〈《C# 编程 指南 ) 
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可 重 载运 算 符 (CH RIEA) 


C# 通过 使 用 operator 关键 字 定 义 静 态 成 员 画 数 ， 来 允许 用 户 定义 的 类 型 重 栽 运算 
符 。 不 过 并 非 所 有 运算 符 都 可 以 进行 重 载 ， 并 且 其 他 运算 符 具 有 限制 ， 如 下 表 所 
All : 


运算 符 


+、-、!、~、++、--、true、false 


an 73 i lj %, &,], A, <<, >> 


ET I=, <， a, <= T 


&&, || 


+=, -=, *= /=, %=, &=, |=, A=, <<=, >>= 


= Qu ae 


s PES pas 


>, =>, f(x), as. checked, unchecked, default, delegate. is. new, sizeof, 


y 
Ef TER 


如 果 进 行 重 载 ， 则 比较 运算 符 必须 成 对 进行 重 载 ; 世 就 是 说 ， 如 果 cc 进行 重 
载 ， 则 != 也 必须 进行 重 载 。 反 之 亦 然 ， 对 于 < 和 > 以 及 <= 和 >= 也 是 类 似 情 
况 。 


若 要 在 自 定 义 类 上 重 载运 算 符 ， 需 要 在 该 类 上 创建 具有 正确 签名 的 方法 。 B 
须 命 名 为 “运算 符 X"， 其 中 X 是 重 载 的 运算 符 的 名 称 或 符号 。 一 元 运算 符 具 有 一 
参数 ， 二 元 运算 符 具有 两 个 参数 。 在 每 种 情况 下 ， 都 必须 有 一 个 参数 与 声明 运 B 
的 类 或 结构 的 类 型 相同 。 


public static Complex operator +(Complex ci, Complex c2) 


( 


Return new Complex(ci.real + c2.real, ci.imaginary + c2.im: 


| 8 


E 对 于 这 些 情况 ， 有 一 种 使 用 => 的 语法 快捷 
方式 。 





public static Complex operator +(Complex c1, Complex c2) => 
new Complex(ci.real + c2.real, ci.imaginary + c2.imaginary: 


// Override ToString() to display a complex number 


// in the traditional format: 
public override string ToString() => $"{this.real} + {this. imac 


| m B 
有 关 详 细 新 ， 请 参阅 如 何 : 使 用 运算 符 重 载 创建 复数 类 (CH 编程 指南 ) o 





请 参阅 
C# 编程 指南 
语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


运算 符 (CH 编程 指南 ) 
C# 运算 符 
重 载 的 运算 符 为 何在 CH 中 始终 为 静态 ? 


可 重 载 运算 符 (CH 编程 指南 ) 474 


转换 运算 符 (CH 编程 指南 ) 


CH 人 允许 程序 员 在 类 或 结构 上 声明 转换 ， 以 便 类 或 结构 与 其 他 类 或 结构 或 者 基本 类 
型 进行 相互 转换 。 转 换 的 定义 方法 类 似 于 运算 符 ， 并 根据 它们 所 转换 到 的 类 型 命 
名 。 要 转换 的 参数 类 型 或 转换 结果 的 类 型 必须 是 (不 能 两 者 同时 都 是 ) 包含 类 型 。 
class SampleClass 
public static explicit operator SampleClass(int i) 
{ 
SampleClass temp = new SampleClass(); 
// code to convert from int to SampleClass... 


return temp; 


转换 运算 符 概 述 


转换 运算 符 具 有 以 下 特点 : 
e 声明 为 implicit 的 转换 在 需要 时 自动 进行 。 
e 声明 为 explicit 的 转换 需要 调用 强制 转换 。 
e. 所 有 转换 都 必须 声明 为 static. 


相关 章节 
有 关 更 多 信息 : 
e 使 用 转换 运算 符 (CH 编程 指南 ) 
e 强制 转换 和 类 型 转换 (CH 编程 指南 ) 
e 如 何 : 在 结构 间 实 现 用 户 定义 的 转换 (CH 编程 指南 ) 
e explicit (C# 参考 ) 
e implicit (C# 参考 ) 
e static (C# 参考 ) 


请 参阅 
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Convert 
C# 编程 指南 
在 CH 中 链接 的 用 户 定义 的 显 式 转换 


转换 运算 符 (CH 编程 指南 ) 476 


如 何 : 使 用 运算 符 重 载 创建 复 效 类 (CH 编程 指南 ) 


本 示例 展示 如 何 使 用 运算 符 重 载 创 建 定义 复数 加 法 的 复数 类 Complex。 本 程序 使 用 
ToString 方法 的 重 载 显示 数字 的 虚 部 和 实 部 以 及 加 法 结果 。 


public struct Complex 


{ 


} 


public int real; 
public int imaginary; 


// Constructor. 
public Complex(int real, int imaginary) 
{ 

this.real = real; 

this.imaginary = imaginary; 


} 


// Specify which operator to overload (+), 

// the types that can be added (two Complex objects), 

// and the return type (Complex). 

public static Complex operator +(Complex c1, Complex c2) 


i 
} 


return new Complex(c1.real + c2.real, c1.imaginary + c2.im: 


// Override the ToString() method to display a complex number 
// in the traditional format: 
public override string ToString() 


{ 
} 


return (System.String.Format("{0} + {1}i", real, imaginary: 


class TestComplex 


{ 


static void Main() 
{ 
Complex numi 
Complex num2 


- new Complex(2, 3); 

- new Complex(3, 4); 

// Add two Complex objects by using the overloaded + operat 
Complex sum = numi + num2; 


// Print the numbers and the sum by using the overridden 
// ToString method. 

System.Console.WriteLine("First complex number: {0}", num: 
System.Console.WriteLine("Second complex number: {0}", num: 
System.Console.WriteLine("The sum of the two numbers: {0}", 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 

} 


} 

/* Output: 
First complex number: 2 + 3i 
Second complex number: 3 + 4i 
The sum of the two numbers: 5 + 7i 





请 参阅 


C# 编程 指南 
C# 运算 符 
运算 符 (CH 参考 ) 


Why are overloaded operators always static in C£? (在 C£ 中 ， 为 什么 重 载 的 运算 
符 始 终 是 静态 的 ?) 


相等 比较 (CH 编程 指 两 ) 


有 时 必须 比较 两 个 值 是 否 相等 。 在 某 些 情况 下 ， 您 测试 的 是 “ 值 相 等 性 ”( 也 称 为 “等 
效 性 ”) ， 意 即 两 个 变量 包含 的 值 相等 。 而 在 其 他 情况 下 ， 则 必须 确定 两 个 变量 是 否 
引用 内 存 中 的 同一 基础 对 象 。 这 种 类 型 的 相等 性 称 为 “引用 相等 性 ”( 或 “标识 ”) 。 本 
主题 描述 这 两 种 相等 性 ， 并 提供 指向 其 他 主题 的 链接 以 了 解 更 多 信息 。 


引用 相等 性 


引用 相等 性 是 指 两 个 对 象 引 用 均 引 用 同一 基础 对 象 。 通过 简单 的 赋值 来 实 
现 ， 如 下 面 的 示例 所 示 。 


using System; 
class Test 


{ 

public int Num { get; set; } 

public string Str { get; set; } 

static void Main() 

{ 
Test a = new Test() { Num = 1, Str = "Hi" }; 
Test b = new Test() { Num = 1, Str = "Hi" }; 
bool areEqual = System.Object.ReferenceEquals(a, b); 
// False: 
System.Console.WriteLine("ReferenceEquals(a, b) = {0}", are 
// Assign b to a. 
b = a; 
// Repeat calls with different results. 
areEqual = System.Object.ReferenceEquals(a, b); 
// True: 
System.Console.WriteLine("ReferenceEquals(a, b) = {0}", ar« 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 

} 

} 





在 此 代码 中 ， 创 建 了 两 个 对 象 ， 但 在 赋值 语句 后 ， 这 两 个 引用 所 引用 的 是 同一 对 
象 。 因 此 ， 使 用 ReferenceEquals 方法 来 确定 两 个 引用 是 否 
引用 同一 对 象 。 


引用 相等 性 的 概念 仅 适用 于 引用 类 型 。 由 于 在 将 值 类 型 的 实例 赋 给 变量 时 将 建立 值 
的 副本 ， 因 此 值 类 型 对 象 无 法 具有 引用 相等 性 。 因 此 ， 永 远 不 能 有 引用 内 存 中 的 同 
一 位 置 的 两 个 未 装 箱 结 构 。 此 外 ， 如 果 您 使 用 ReferenceEquals 来 比较 两 个 值 类 

型 ， 结 果 将 始终 为 false， 即 使 对 象 中 包含 的 值 都 相同 也 是 如 此 。 这 是 因为 每 个 变 
量 都 会 被 装 箱 到 单独 的 对 象 实 例 中 。 有 关 更 多 信息 ， 请 参见 如 何 : 测试 引用 相等 性 
(标识 ) (CH 编程 指南 ) o 


值 相等 性 


值 相 等 性 是 指 两 个 对 象 包 含 相 同 的 一 个 或 多 个 值 。 对 于 基 元 值 类 型 《例如 int 或 
bool) ， 针 对 值 相等 性 的 测试 简单 明了 。 您 可 以 使 用 == 运算 符 ， 如 下 面 的 示例 所 
小 。 


int a = GetOriginalValue(); 
int b = GetCurrentValue(); 


// Test for value equality. 
if( b -- a) 


// The two integers are equal. 


对 于 大 多 数 其 他 类 型 ， 针 对 值 相等 性 的 测试 较为 复杂 ， 因 为 它 需要 您 了 解 类 型 对 值 
相等 性 的 定义 方式 。 对 于 具有 多 个 字段 或 属性 的 类 和 结构 ， 值 相等 性 的 定义 通常 是 
指 所 有 字段 或 属性 都 具有 相同 的 值 。 例 如 ， 如 果 pointA.X 等 于 pointB.X， 并 且 
pointA.Y 等 于 pointB.Y， 则 可 以 将 两 个 Point 对 象 定义 为 相等 。 


不 过 ， 并 不 要 求 类 型 中 的 所 有 字段 均 相等 。 只 需 子 集 相 等 即 可 。 在 比较 不 属于 您 的 
类 型 时 ， 应 确保 明确 了 解 相 等 性 对 于 该 类 型 是 如 何 定义 的 。 有 关 如 何在 您 自己 的 类 
ee A 8 
BFA) e 


浮 点 值 的 值 相等 性 


由 于 二 进 制 计算 机 上 浮 点 算法 的 不 精确 性 ， 因 此 浮 点 值 (double fll float) 的 相等 
比较 会 出 现 问 题 。 有 关 更 多 信息 ， 请 参见 主题 System.Double 中 的 备注 。 


相关 主题 


MSDN CH 编程 指南 & 参考 手册 2015 


标题 


如 何 : 测试 引用 相等 
性 (标识) (CH 编程 
指南 ) 

如 何 : 为 类 型 定义 值 
相等 性 (CH 编程 指 
Fa) 


C 编程 指南 


类 型 (CH 编程 指南 ) 


请 


Y 


阅 
C# 编程 指南 


相等 比较 (CH 编程 指南 ) 


描述 如 何 确 定 两 个 变量 是 否 具 有 引用 相等 性 。 


描述 如 何 为 类 型 提供 值 相等 性 的 自 定义 定义 。 


提供 一 些 链接 ， 这 些 链接 指向 有 关 重 要 的 C# 语言 功 
能 以 及 通过 .NET Framework 提供 给 C# 的 功能 的 详 
细 信 息 息 。 


o 


字符 串 (CH 编程 指南 ) 


字符 串 是 String 类 型 的 对 象 ， 它 的 值 是 文本 。 在 内 部 ， 文 本 被 存储 为 Char 对 象 的 
顺序 只 读 集合 。C# 字符 串 末 尾 没 有 以 null 结尾 的 字符 ; 因此 C# 字符 串 可 以 包含 
任意 数目 的 藤 入 式 null 字符 (40°) 。 字 符 串 的 Length 属性 代表 它 包含 的 Char 对 
象 的 数量 ， 而 不 是 Unicode 字符 的 数量 。 若 要 访问 字符 串 中 的 各 个 Unicode 码 
位 ， 请 使 用 StringInfo 对 象 。 


字符 串 与 System.String 


在 C# 中 ，string 关键 字 是 String 的 别名 。 因 此 ，String 与 string 等 效 ， 您 可 以 
根据 自己 的 喜好 选择 命名 约定 。 String 类 提供 了 很 多 用 于 安全 地 创建 、 操 作 和 比 
较 字 符 串 的 方法 。 此 外 ，C# 语言 还 重 载 某 些 运算 符 来 简化 常见 的 字符 串 操作 。 有 
关 关 键 字 的 更 多 信息 ， 请 参见 string (C£ 参考 ) 。 有 关 类 型 及 其 方法 的 更 多 信息 ， 
请 参见 String。 


声明 和 初始 化 字符 串 
可 以 通过 各 种 方式 来 声明 和 初始 化 字符 串 ， 如 下 面 的 示例 所 示 : 


// Declare without initializing. 
string message1; 


// Initialize to null. 
string message2 - null; 


// Initialize as an empty string. 
// Use the Empty constant instead of the literal "". 
string message3 - System.String.Empty; 


//Initialize with a regular string literal. 
string oldPath = "c:\\Program Files\\Microsoft Visual Studio 8.0"; 


// Initialize with a verbatim string literal. 
string newPath = @"c:\Program Files\Microsoft Visual Studio 9.0"; 


// Use System.String if you prefer. 
System.String greeting = "Hello World!"; 


// In local variables (i.e. within a method body) 
// you can use implicit typing. 
var temp = "I'm still a strongly-typed System.String!"; 


// Use a const string to prevent 'message4' from 
// being used to store another string value. 
const string message4 = "You can't get rid of me!"; 


// Use the String constructor only when creating 
// a string from a char*, char[], or sbyte*. See 
// System.String documentation for details. 
char[] letters = { 'A', 'B', 'C' Y; 

string alphabet - new string(letters); 


Aoo Bl 


E 除了 在 使 用 字符 数组 初始 化 字符 串 时 以 外 ， 不 要 使 用 new 运算 符 创 建 字符 串 
对 象 。 


使 用 Empty 常量 值 初始 化 字符 串 可 新 建 字符 捉 长 度 为 需 的 String tR. SKEF 
符 串 的 字符 串 表 示 形 式 为 "|. A Empty 值 (而 不 是 nul) 初始 化 字符 串 可 以 降低 
R Æ NullReferenceException 的 可 能 性 。 请 在 尝试 访问 字符 串 之 前 使 用 静态 
IsNullOrEmpty(String) 方法 验证 字符 串 的 值 。 


字符 串 对 象 的 不 可 变性 


字符 串 对 象 是 不 可 变 的 : 即 它们 创建 之 后 就 无 法 更 改 。 所 有 看 似 修改 字符 串 的 
String 方法 和 CH 运算 符 实际 上 都 以 新 字符 串 对 象 的 形式 返回 结果 。 在 下 面 的 示例 
中 ， 当 连接 s1 和 s2 的 内 容 以 形成 一 个 字符 串 时 ， 不 会 修改 两 个 原始 字符 串 。 + 
运算 符 会 创建 一 个 包含 组 合 内 容 的 新 字符 串 。 这 个 新 对 象 赋 给 变量 1, MDMA 
s1 的 对 象 由 于 没有 其 他 任何 变量 包含 对 它 的 引用 而 释放 ， 用 于 垃圾 回收 。 


"A string is more "; 
"than the sum of its chars."; 


string si = 
string s2 = 
// Concatenate s1 and s2\. This actually creates a new 
// string object and stores it in si, releasing the 

// reference to the original object. 

S1 += S2; 


System.Console.WriteLine(s1); 
// Output: A string is more than the sum of its chars. 


由 于 “修改 "字符 串 实际 上 是 创建 新 字符 串 ， 因 此 创建 对 字符 串 的 引用 时 必须 谨慎 。 
如 果 创 建 了 对 字符 串 的 引用 ， 然 后 “修改 "原始 字符 串 ， 则 该 引用 指向 的 仍 是 原始 对 
象 ， 而 不 是 修改 字符 串 时 创建 的 新 对 象 。 下 面 的 代码 说 明了 这 种 行为 : 


string si = "Hello "; 
string s2 - s1; 
si += "World"; 


System.Console.WriteLine(s2); 
//Output: Hello 


有 关 如 何 创建 基于 修改 (例如 搜索 和 蔡 换 原始 字符 串 的 操作 ) 的 新 字符 串 的 更 多 信 
息 ， 请 参见 如 何 : 修改 字符 串 内 容 (CH 编程 指南 ) o 


正则 字符 串 和 原 义 字符 串 
如 果 必 须 散 入 CH 提供 的 转 义 符 ， 则 应 使 用 正则 字符 串 ， 如 下 面 的 示例 所 示 : 


string columns = "Column 1\tColumn 2NtColumn 3"; 
//Output: Column 1 Column 2 Column 3 


string rows = "Row 1\r\nRow 2\r\nRow 3"; 
/* Output: 

Row 1 

Row 2 

Row 3 
A 


string title = "\"The Nu00C60lean Harp\", by Samuel Taylor Colerid¢ 
//Output: "The Aolean Harp", by Samuel Taylor Coleridge 


E — 


如 果 字 符 串 文本 包含 反 斜 杠 字符 〈 例 如 在 文件 路 径 中 ) ， 为 方便 起 见 和 提高 可 读 
性 ， 应 使 用 原 义 字符 串 。 由 于 原 义 字符 串 保 留 换行 符 作 为 字符 串 文 本 的 一 部 分 ， 
此 可 用 于 初始 化 多 行 字符 串 。 在 原 义 字符 串 中 散人 入 引号 时 请 使 用 双 引 号 。 下 面 的 示 





例 演 示 原 义 字 符 串 的 一 些 常见 用 途 : 


string filePath = @"C:\Users\scoleridge\Documents\"; 
//Output: C:\Users\scoleridge\Documents\ 


string text = Q"My pensive SARA ! thy soft cheek reclined 
Thus on mine arm, most soothing sweet it is 
To sit beside our Cot,..."; 
/* Output: 
My pensive SARA ! thy soft cheek reclined 
Thus on mine arm, most soothing sweet it is 
To sit beside our Cot,... 
A 


string quote - Q"Her name was ""Sara."""; 
//Output: Her name was "Sara." 


字符 串 转 义 序 列 


转 义 序列 字符 名 称 Unicode 编码 
V 单 引 号 0x0027 

i3 AUS 0x0022 

\ RHI 0x005C 

V0 Null 0x0000 

\a 警报 0x0007 

\b Backspace 0x0008 

\f 换 页 0x000C 

\n 换行 0x000A 

\r [p] 车 0x000D 

\t 水 平 制 表 符 0x0009 

\U 代理 项 对 的 Unicode 转 义 序列 。 \Unnnnnnnn 
\u Unicode 转 义 序列 \u0041 = "A" 
\v 垂直 制 表 符 0x000B 


B Unicode 转 义 序列 类 似 于 ^\u"”， 只 是 长 度 可 变 。 \x0041 = "A" 


te 
E. TER 


编译 时 ， 原 义 字 符 串 转 换 为 所 有 转 义 序列 均 保持 不 变 的 普通 字符 串 。 因 而 ， 如 
果 在 调试 器 监视 窗口 中 查看 原 义 字符 串 ， 则 看 到 的 将 是 编译 器 添加 的 转 义 字 
符 ， 而 不 是 源 代 码 中 的 原 义 版 本 。 例 如 ， 原 义 字 符 串 @"C:\files.txt" 在 监视 窗口 
中 将 显示 为 "Ci\files.txt"。 
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格式 字符 串 是 内 容 可 以 在 运行 时 动态 确定 的 一 种 字符 串 。 采 用 以 下 方式 创建 格式 字 
符 串 : 使 用 静态 Format 方法 并 在 大 括号 中 赔 入 占 位 符 ， 这 些 占 位 符 将 在 运行 时 蔡 
换 为 其 他 值 。 下 面 的 示例 使 用 格式 字符 串 输 出 循环 中 每 个 迭代 的 结果 : 


class FormatString 


( 


static void Main() 


i 


// Get user input. 
System.Console.WriteLine("Enter a number"); 
string input - System.Console.ReadLine(); 


// Convert the input string to an int. 
int j; 
System. Int32.TryParse(input, out j); 


// Write a different string each iteration. 

string S; 

for (int i = 0; i < 10; i++) 

{ 
// A simple format string with no alignment formatting 
s = System.String.Format("{0} times {1} = {2}", i, j, ! 
System.Console.WriteLine(s); 


} 


//Keep the console window open in debug mode. 
System.Console.ReadKey(); 





WriteLine 方法 的 一 个 重 载 将 格式 字符 串 用 作 参 数 。 因 此 ， 可 以 只 做 入 格式 字符 

串 ， 而 无 需 显 式 调用 该 方法 。 但 若 使 用 WriteLine 方法 在 Visual Studio“ 输 出 ”窗口 

中 显示 调试 输出 ， 则 必须 显 式 调用 Format 方法 ， 因 为 WriteLine 只 接受 字符 串 ， 

no pe See a ee 
AE 3. 


子 字 符 串 


子 字符 串 是 包含 在 字符 串 中 的 任意 字符 序列 。 使 用 Substring 方法 可 以 基于 原始 字 
符 串 的 一 部 分 创建 新 字符 串 。 可 以 使 用 IndexOf 方法 搜索 子 字符 串 的 一 个 或 多 个 匹 
配 项 。 使 用 Replace 方法 可 将 指定 子 字符 串 的 所 有 匹配 项 替换 为 一 个 新 字符 串 。 和 与 
Substring 方法 一 样 ，Replace 实际 上 返回 的 也 是 新 字符 串 ， 而 不 修改 原始 字符 
串 。 有 关 更 多 信息 ， 请 参见 如 何 : 使 用 字符 串 方法 搜索 字符 串 (CH 编程 指南 ) 和 
如 何 : 修改 字符 串 内 容 (CH 编程 指南 ) o 


string s3 = "Visual C£ Express"; 
System.Console.WriteLine(s3.Substring(7, 2)); 
// Output: "Cz" 


System.Console.WriteLine(s3.Replace("C#", "Basic")); 
// Output: "Visual Basic Express" 


// Index values are zero-based 


int index = s3.IndexOf("C"); 
// index = 7 


访问 各 个 字符 
可 以 使 用 带 索 引 值 的 数组 表示 法 获取 对 各 个 字符 的 只 读 访 问 ， 如 下 面 的 示例 所 示 : 


string s5 = "Printing backwards"; 
for (int i = 0; i < s5.Length; i++) 
System.Console.Write(s5[s5.Length - i - 1]); 
// Output: "sdrawkcab gnitnirP" 
如 果 String 方法 不 提供 修改 字符 串 中 的 各 个 字符 所 必须 具有 的 功能 ， 则 您 可 以 使 用 
StringBuilder 对 象 “ 就 地 ”修改 各 个 字符 ， 然 后 使 用 StringBuilder 方法 创建 一 个 新 字 


符 串 来 存储 结果 。 在 下 面 的 示例 中 ， 假 设 您 必须 以 特定 方式 修改 原始 字符 串 ， 然 后 
存储 结果 以 备 将 来 使 用 : 


string question = "hOW DOES mICROSOFT wORD DEAL WITH THE CAPS LOCK 
System.Text.StringBuilder sb = new System.Text.StringBuilder (quest: 


for (int j = 0; j < sb.Length; j++) 


if (System.Char.IsLower(sb[j]) == true) 
sb[j] = System.Char.ToUpper(sb[j]); 

else if (System.Char.IsUpper(sb[j]) == true) 
sb[j] = System.Char.ToLower(sb[j]); 


// Store the new string. 

string corrected = sb.ToString(); 
System.Console.WriteLine(corrected); 

// Output: How does Microsoft Word deal with the Caps Lock key? 


4 = 


Null 字符 串 和 空 字符 串 


空 字 符 串 是 不 包含 字符 的 System.String 对 象 的 实例 。 在 各 种 编程 方案 中 经 常会 使 
用 空 字 符 串 表示 空白 文本 字段 。 可 以 对 空 字符 串 调 用 方法 ， 因 为 它们 是 有 效 的 
System.String 对 象 。 空 字符 串 可 按 如 下 方式 初始 化 : 





string s = String.Empty; 


AAR, null 字符 串 并 不 引用 System.String 对 象 的 实例 ， 任 何 对 null 字符 串 调 用 方 
法 的 尝试 都 会 生成 NullIReferenceException。 但 是 ， 可 以 在 串联 和 比较 操作 中 将 
null 字符 串 与 其 他 字符 串 一 起 使 用 。 下 面 的 示例 阐释 了 引用 null 字符 串 导 致 引 发 异 
常 的 情形 以 及 并 不 导致 引发 异常 的 情形 : 


static void Main() 


{ 
string str = "hello"; 
string nullStr = null; 
string emptyStr = String.Empty; 
string tempStr = str + nullStr; 
// Output of the following line: hello 
Console.WriteLine(tempStr ); 
bool b = (emptyStr == nullStr); 
// Output of the following line: False 
Console.WriteLine(b); 
// The following line creates a new empty string. 
string newStr = emptyStr + nullStr; 
// Null strings and empty strings behave differently. The foll 
// two lines display ©. 
Console.WriteLine(emptyStr.Length); 
Console.WriteLine(newStr.Length); 
// The following line raises a NullReferenceException. 
//Console.WriteLine(nullStr.Length); 
// The null character can be displayed and counted, like other 
string s1 = "\x0" + "abc"; 
string s2 = "abc" + "\x0"; 
// Output of the following line: * abc* 
Console.WriteLine("*" + s1 + "*"); 
// Output of the following line: *abc * 
Console.WriteLine("*" + s2 + "*"); 
// Output of the following line: 4 
Console.WriteLine(s2.Length); 

} 





使 用 StringBuilder 快速 创建 字符 串 


NET 中 的 字符 串 操作 已 高 度 优化 ， 大 多 数 情况 下 不 会 显著 影响 性 能 。 但 在 某 些 应 
用 场景 中 ， 例 如 在 执行 好 几 百 甚至 好 几 千 次 的 紧凑 循环 中 ， 字 符 串 操作 会 影响 性 

能 。 StringBuilder 类 创建 了 一 个 字符 串 缓冲 区 ， 用 于 在 程序 执行 大 量 字符 串 操作 时 
提供 更 好 的 性 能 。 StringBuilder 字符 串 还 使 您 能 够 重新 分 配 个 别 字符 (ABLE 
E. o sre ne ee a 
FE JAR: 


System.Text.StringBuilder sb - new System.Text.StringBuilder("Rat: 
sb[0] = 'C'; 

System.Console.WriteLine(sb.ToString()); 
System.Console.ReadLine(); 


//Outputs Cat: the ideal pet 








在 本 示例 中 ，StringBuilder 对 象 用 于 从 一 组 数值 类 型 中 创建 字符 串 : 


class TestStringBuilder 


{ 
static void Main() 
{ 
System.Text.StringBuilder sb = new System. Text.StringBuilde 
// Create a string composed of numbers 0 - 9 
for (Ant i = 0; i < 10; i++) 
{ 
sb.Append(i.ToString()); 
System.Console.WriteLine(sb); // displays 0123456789 
// Copy one character of the string (not possible with a S 
sb[0] = sb[9]; 
System.Console.WriteLine(sb); // displays 9123456789 
} 
} 





FFP, y RDM LINQ 


由 于 String 类 型 实现 IEnumerable<T>， 因 此 可 以 对 字符 串 使 用 Enumerable 类 中 
定义 的 扩展 方法 。 对 于 String 类 型 ， 为 了 避免 视觉 上 的 混乱 ， 从 IntelliSense 中 排 
除了 这 些 方 法 ， 但 这 些 方法 仍然 可 用 。 此 外 ， 还 可 以 对 字符 串 使 用 LINQ 查询 表达 
式 。 有 关 更 多 信息 ， 请 参见 LINQ and Strings. 


相关 主题 


MSDN CZ 编程 指南 & 参考 手册 2015 


主题 


如 何 : 修改 字符 串 内 
A (CH 编程 指南 ) 


如 何 : 串联 多 个 字符 
FR (CH 编程 指南 ) 


如 何 : 比较 字符 串 
(CH 编程 指南 ) 


如 何 : 拆 分 字符 串 
(CH 编程 指南 ) 


如 何 : 使 用 字符 串 方 
法 搜索 字符 串 (CH 编 
程 指南 ) 


如 何 : 使 用 正则 表达 
式 搜索 字符 串 (CH 编 
程 指南 ) 


如 何 : 确定 字符 串 是 
否 表 示 数 值 (CH 编程 
指南 ) 


如 何 : 将 字符 串 转 换 
为 DateTime (CZ 编 
程 指南 ) 


.NET Framework 中 的 


基本 字符 串 操 作 
f£ .NET Framework 
中 分 析 字 符 串 


在 .NET Framework 
中 比较 字符 串 


在 .NET Framework 
中 使 用 StringBuilder 
SK 


zx 


LINQ and Strings 


C4 编程 指南 


SHB (CH 编程 指南 ) 


说 明 
提供 一 个 代码 示例 来 演示 如 何 修改 字符 串 的 内 容 。 


阅 释 如 何 使 用 + 运算 符 和 Stringbuilder 类 在 编译 时 
和 运行 时 将 字符 串联 接 在 一 起 。 


演示 如 何 执 行 字 符 串 的 序号 比较 。 


包含 一 个 代码 示例 ， 该 示例 演示 如 何 使 用 
String.Split 方法 来 分 析 字 符 串 。 


解释 如 何 使 用 特定 方法 来 搜索 字符 串 。 


解释 如 何 使 用 正则 表达 陈 来 搜索 字符 串 。 


演示 如 何 安 全 地 分 析 字 符 串 以 了 解 其 是 否 具 有 有 效 数 
值 。 


演示 如 何 将 诸如 "01/24/2008" 这 样 的 字符 串 转 换 为 
System.DateTime 对 象 。 


提供 一 些 指向 主题 的 链接 ， 这 些 主题 使 用 
System.String 和 System.Text.StringBuilder 方法 来 
执行 基本 字符 串 操 作 。 


介绍 如 何 将 字符 或 空格 插入 到 字符 串 中 。 


包含 有 关 如 何 比较 字符 串 的 信息 ， 并 且 提 供 使 用 C# 
和 Visual Basic 编写 的 示例 。 


描述 如 何 使 用 StringBuilder 类 创建 和 修改 动态 字符 串 
对 象 。 


提供 有 关 如 何 使 用 LINQ 查询 来 执行 各 种 字符 串 操作 


YIA eo 


提供 指向 解释 C# 中 编程 构造 的 主题 的 链接 。 


MSDN C# 编程 指南 & 参考 手册 2015 


More About Variables 在 Beginning Visual C# 2010 


SA (CH 编程 指南 ) 492 


如 何 : 串联 多 个 字符 串 (CH 编程 指 丙 ) 


串联 是 将 一 个 字符 串 追 加 到 另 一 个 字符 串 末 尾 的 过 程 。 使 用 + 运算 符 串 联 字符 串 文 
本 或 字符 串 常 量 时 ， 编 译 器 会 创建 一 个 字符 串 。 串 联 不 在 运行 时 发 生 。 但 字符 串 变 
量 只 能 在 运 行 时 串联 ， 对 此 ， 您 应 该 ST BAA KER EBL. 


下 面 的 示例 演示 如 何 将 一 个 长 字符 串 拆 分 为 几 个 较 短 的 字符 串 ， 从 而 提高 源 代 码 的 
可 读 性 。 这 些 较 短 的 字符 串 将 在 编译 时 串联 成 一 个 字符 串 。 无 论 涉及 到 多 少 个 字符 
串 ， 都 不 会 有 运行 时 性 能 开销 。 


static void Main() 

{ 
// Concatenation of literals is performed at compile time, not 
string text = "Historically, the world of data and the world o! 
"have not been well integrated. Programmers work in C£ or Visu: 
"and also in SQL or XQuery. On the one side are concepts such : 
"objects, fields, inheritance, and .NET Framework APIs. On the 
"are tables, columns, rows, nodes, and separate languages for « 
"them. Data types often require translation between the two woi 
"different standard functions. Because the object world has no 
"query can only be represented as a string without compile-time 
"IntelliSense support in the IDE. Transferring data from SQL t: 
"objects in memory is often tedious and error-prone."; 


Console.WriteLine(text); 


国医 


若 要 串联 字符 串 变 量 ， 可 以 使 用 + 或 += 运算 符 ， 也 可 以 使 用 
String.Concat、String.Format 或 StringBuilderAppend 方法 。 + 运算 符 容 易 使 

用 ， 且 有 利于 提高 代码 的 直观 性 。 即 使 在 一 条 语句 中 使 用 多 个 + 运算 符 ， 字 符 串 内 
容 也 将 只 复制 一 次 。 但 是 ， 如 果 重 复 此 操作 多 次 〈 如 使 用 循环 ) ， 则 可 能 会 导致 出 
现 效率 问题 。 例 如 ， 考 虑 下 面 的 代码 : 





static void Main(string[] args) 


{ 
// To run this program, provide a command line string. 
// In Visual Studio, see Project > Properties > Debug. 
string userName = args[0]; 
string date = DateTime.Today.ToShortDateString(); 
// Use the + and += operators for one-time concatenations. 
string str = "Hello " + userName + ". Today is " + date + "."; 
System.Console.WriteLine(str); 
str += " How are you today?"; 
System.Console.WriteLine(str); 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 

} 


// Example output: 

// Hello Alexander. Today is 1/22/2008. 

// Hello Alexander. Today is 1/22/2008\. How are you today? 
// Press any key to exit. 


A. 
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在 字符 串 串 联 操作 中 ，C# 编译 器 对 null 字符 串 和 空 字符 串 进行 相同 的 义理 ， 但 
它 不 转换 原始 null 字符 串 的 值 。 


如 果 您 串联 的 字符 串 数量 不 那么 巨大 〈 例 如 ， 在 循环 中 ) ， 那 么 这 些 代码 的 性 能 成 
本 可 能 不 会 很 高 。 上 述 情况 同样 适用 于 String.Concat 和 String.Format Aik. 


但 如 果 性 能 的 优 劣 很 重要 ， 则 应 该 总 是 使 用 StringBuilder 类 来 串联 字符 串 。 下 面 的 
代码 使 用 StringBuilder 类 的 Append 方法 来 串联 字符 串 ， 因 此 不 会 有 + 运算 符 的 
链接 作用 产生 。 


class StringBuilderTest 


{ 
static void Main() 
{ 
string text = null; 
// Use StringBuilder for concatenation in tight loops. 
System.Text.StringBuilder sb = new System. Text.StringBuilde 
for (int i = 0; i < 100; i++) 
sb.AppendLine(i.ToString()); 
} 
System.Console.WriteLine(sb.ToString()); 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
// Output: 
// 0 
fe aL 
// 2 
// 3 
// 4 
// 
// 





String 


StringBuilder 
C# 编程 指南 
SAB (CH 编程 指南 ) 


如 何 : 修改 字符 串 内 容 (CH 编程 指南 ) 


由 于 字符 串 是 不 可 变 的 ， 因 此 一 个 字符 串 对 象 一 旦 创建 ， 值 就 不 能 再 更 改 (ERE 
用 不 安全 代码 的 情况 下 ) 。 不 过 ， 修 改 字 符 串 的 值 然 后 将 结果 存储 到 新 的 字符 串 对 
象 中 有 很 多 种 方法 。 System.String 类 提供 作用 于 输入 字符 串 并 返回 新 字符 串 对 象 
的 方法 。 在 很 多 情况 下 ， 可 以 将 这 个 新 对 象 赋 给 保存 原始 字符 串 的 变量 。 
System.Text.RegularExpressions.Regex 类 提供 其 他 一 些 以 类 似 方式 工作 的 方法 。 
System.Text.StringBuilder 类 提供 一 个 可 “就 地 ”修改 的 字符 缓冲 区 。 调 用 
StringBuilder.ToString 方法 可 新 建 包含 此 缓冲 区 的 当前 内 容 的 字符 串 对 象 。 


下 面 的 示例 演示 蔡 换 或 移 除 指定 字符 串 中 的 子 字 符 串 的 各 种 方法 。 


class ReplaceSubstrings 
{ 
string searchFor; 
string replaceWith; 


static void Main(string[] args) 


{ 


ReplaceSubstrings app = new ReplaceSubstrings(); 
string s = "The mountains are behind the clouds today."; 


// Replace one substring with another with String.Replace. 
// Only exact matches are supported. 

S = s.Replace("mountains", "peaks"); 

Console.WriteLine(s); 

// Output: The peaks are behind the clouds today. 


// Use Regex.Replace for more flexibility. 

// Replace "the" or "The" with "many" or "Many". 

// using System.Text.RegularExpressions 

app.searchFor - "the"; // A very simple regular expression 
app.replacewith - "many"; 

s = Regex.Replace(s, app.searchFor, app.ReplaceMatchCase, Ff 
Console.WriteLine(s); 

// Output: Many peaks are behind many clouds today. 


// Replace all occurrences of one char with another. 
S = s.Replace(' ', ' '); 

Console.WriteLine(s); 

// Output: Many peaks are behind many clouds today. 


// Remove a substring from the middle of the string. 


string temp - "many "; 
int i - s.IndexOf(temp); 
if (i »- 0) 

{ 


S = s.Remove(i, temp.Length); 


} 


Console.WriteLine(s); 
// Output: Many_peaks_are_behind_clouds_today. 


// Remove trailing and leading whitespace. 

// See also the TrimStart and TrimEnd methods. 
string s2 = " I'm wider than I need to be. f 
// Store the results in a new string variable. 

temp = s2.Trim(); 

Console.WriteLine(temp); 

// Output: I'm wider than I need to be. 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit"); 
Console.ReadKey(); 

J 


// Custom match method called by Regex.Replace 
// using System.Text.RegularExpressions 
string ReplaceMatchCase(Match m) 


// Test whether the match is capitalized 
if (Char.IsUpper(m.Value[0]) -- true) 


{ 
// Capitalize the replacement string 
// using System.Text; 
StringBuilder sb = new StringBuilder(replaceWith); 
sb[0] = (Char.ToUpper(sb[0])); 
return sb.ToString(); 

} 

else 

{ 
return replaceWith; 

} 





若 要 使 用 数组 表示 法 访问 字符 串 中 的 各 个 字符 ， 可 以 使 用 StringBuilder 对 象 ， 该 对 
RER J 运算 符 以 提供 对 其 内 部 字符 缓冲 区 的 访问 。 也 可 以 使 用 ToCharArray 方法 
将 该 字符 串 转 换 为 一 个 字符 数组 。 下 面 的 示例 使 用 ToCharArray 创建 该 数组 。 然 
后 修改 该 数组 中 的 某 些 元 素 。 之 后 再 调用 采用 一 个 字符 数组 作为 输入 参数 的 字符 串 
构造 本 数 来 创建 一 个 新 字符 串 。 


class ModifyStrings 
{ 
static void Main() 
{ 
string str = "The quick brown fox jumped over the fence"; 
System.Console.WriteLine(str); 


char[] chars = str.ToCharArray(); 

int animalIndex - str.IndexOf("fox"); 

if (animalIndex !- -1) 

{ 
chars[animalIndex++] 
chars[animalIndex++] 
chars[animalIndex] = 


} 


string str2 = new string(chars); 
System.Console.WriteLine(str2); 


// Keep the console window open in debug mode 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


j 


} 
/* Output: 
The quick brown fox jumped over the fence 


The quick brown cat jumped over the fence 
d 


o ————— ——H— m": | 


下 面 的 示例 针对 的 是 一 种 非常 罕见 的 情况 ， 即 您 可 能 希望 使 用 不 安全 代码 以 类 似 于 
C 祥 式 字符 数组 的 方式 就 地 修改 字符 串 。 此 示例 演示 如 何 使 用 fixed 关键 字 ' 就 地 ” 访 
问 各 个 字符 。 此 外 还 演示 对 字符 串 进行 不 安全 操作 可 能 产生 的 一 个 副作用 ， 此 副 作 
用 是 由 于 CH 编译 器 在 内 部 存储 〈 暂 存 ) 字符 串 的 方式 而 导致 的 。 通 常 ， 除 非 绝 对 
必要 ， 否 则 不 应 该 使 用 这 种 方法 。 


class UnsafeString 
{ 
unsafe static void Main(string[] args) 
{ 
// Compiler will store (intern) 
// these strings in same location. 
string s1 = "Hello"; 
string s2 = "Hello"; 


// Change one string using unsafe code. 
fixed (char* p = s1) 


plo] = 'C'; 
// Both strings have changed. 
Console.WriteLine(s1); 
Console.WriteLine(s2); 
// Keep console window open in debug mode. 


Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


请 参阅 


C# 编程 指南 
字符 串 (CH 编程 指南 ) 


如 何 : 比较 字符 串 〈C# 编程 指南 ) 


比较 字符 串 时 ， 产 生 的 结果 会 是 一 个 字符 串 大 于 或 小 于 另 一 个 字符 串 ， 或 者 两 个 字 
符 串 相等 。 根 据 执行 的 是 序号 比较 还 是 区 分 区 域 性 比较 ， 确 定 结果 时 所 依据 的 规则 
会 有 所 不 同 。 对 特定 的 任务 使 用 正确 类 型 的 比较 十 分 重要 。 


当 需 要 对 两 个 字符 串 的 值 进行 比较 和 排序 而 不 需要 考虑 语言 惯例 时 ， 请 使 用 基本 的 
序号 比较 。 基 本 的 序号 比较 (System.StringComparison.Ordinal) 是 区 分 大 小 写 
的 ， 这 意味 着 两 个 字符 串 的 字符 必须 完全 匹配 : “and" 不 等 于 “And” 或 AND”。 常 用 
的 变量 有 System.StringComparison.OrdinallgnoreCase， 它 将 匹 

配 “and”、“And" 和 “AND”; 还 有 StringComparison.OrdinallgnoreCase， 它 常用 
于 比较 文件 名 、 路 径 名 和 网 络 路 径 ， 以 及 其 值 不 随 用 户 计算 机 的 区 域 设置 的 更 改 而 
变化 的 任何 其 他 字符 串 。 有 关 更 多 信息 ， 请 参见 System.StringComparison。 


区 分 区 域 性 比较 通常 用 于 对 终端 用 户 输入 的 字符 串 进行 比较 和 排序 ， 因 为 这 些 字符 
串 的 字符 和 排序 约定 可 能 会 根据 用 户 计算 机 的 区 域 设置 的 不 同 而 有 所 不 同 。 即 使 是 
包含 相同 字符 的 字符 串 ， 也 可 能 会 根据 当前 线程 的 区 域 性 不 同 而 不 同 。 


二 
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在 比较 字符 串 时 ， 您 使 用 的 方法 应 该 显 式 指定 了 要 执行 的 比较 类 型 。 这 可 增强 
代码 的 可 维 扩 性 和 可 读 性 。 应 尽 可 能 使 用 具有 StringComparison 枚 举 参 数 的 
System.String 和 System.Array 类 的 方法 重 载 ， 以 便 可 以 指定 要 执行 的 比较 类 
型 。 比 较 字 符 串 时 ， 最 好 避免 使 用 == 和 != 运算 符 。 还 应 该 避免 使 用 
String.CompareTo 实例 方法 ， 因 为 这 些 重 载 没 有 StringComparison。 


下 面 的 示例 演示 如 何 正确 地 比较 其 值 将 不 随 用 户 计算 机 的 区 域 设置 的 改变 而 变化 的 
字符 串 。 此 外 ， 它 还 演示 CH 中 的 字符 串 限 定 功能 。 如 果 程 序 声明 了 两 个 或 更 多 个 
相同 的 字符 串 变 量 ， 编 译 器 会 将 它们 存储 在 同一 位 置 。 通 过 调用 ReferenceEquals 
方法 ， 可 以 看 到 这 两 个 字符 串 实际 引用 内 存 中 的 同一 对 象 。 使 用 String.Copy 方法 
可 避免 此 限定 ， 如 下 面 的 示例 所 示 。 


// Internal strings that will never be localized. 
string root = @"C:\users"; 
string root2 = @"C:\Users"; 


// Use the overload of the Equals method that specifies a StringCor 
// Ordinal is the fastest way to compare two strings. 
bool result - root.Equals(root2, StringComparison.Ordinal); 


Console.WriteLine("Ordinal comparison: {0} and {1} are {2}", root, 
result ? "equal." : "not equal."); 


// To ignore case means "user" equals "User". This is the same as i 

// String.ToUpperInvariant on each string and then performing an o! 

result = root.Equals(root2, StringComparison.OrdinallgnoreCase); 

Console.WriteLine("Ordinal ignore case: (0) and {1} are {2}", root, 
result ? "equal." : "not equal."); 


// A static method is also available. 
bool areEqual = String.Equals(root, root2, StringComparison.Ordina- 


// String interning. Are these really two distinct objects? 
string a - "The computer ate my source code."; 
string b - "The computer ate my source code."; 
// ReferenceEquals returns true if both objects 
// point to the same location in memory. 
if (String.ReferenceEquals(a, b)) 
Console.WriteLine("a and b are interned."); 
else 
Console.WriteLine("a and b are not interned."); 


// Use String.Copy method to avoid interning. 
string c - String.Copy(a); 


if (String.ReferenceEquals(a, c)) 
Console.WriteLine("a and c are interned."); 
else 
Console.WriteLine("a and c are not interned."); 


// Output: 

// Ordinal comparison: C:\users and C:\Users are not equal. 
// Ordinal ignore case: C:\users and C:NUsers are equal. 

// a and b are interned. 

// a and c are not interned. 


加 


下 面 的 示例 演示 如 何 通过 首选 方式 比较 字符 串 ， 该 首选 方式 使 用 具有 
StringComparison 枚 举 的 System.String 方法 。 请 注意 ， 这 里 没有 使 用 
String.CompareTo 实例 方法 ， 因 为 这 些 重 载 没 有 StringComparison。 





// "They dance in the street." 

// Linguistically (in Windows), "ss" is equal to 

// the German essetz: '($' character in both en-US and de-DE culture 
string first = "Sie tanzen in die Strafe."; 

string second = "Sie tanzen in die Strasse."; 


Console.WriteLine("First sentence is {0}", first); 
Console.WriteLine("Second sentence is {0}", second); 


// Store CultureInfo for the current culture. Note that the origin: 
// can be set and retrieved on the current thread object. 

System.Threading.Thread thread - System.Threading.Thread.CurrentThi 
System.Globalization.CultureInfo originalCulture = thread.CurrentCi 


// Set the culture to en-US. 
thread.CurrentCulture - new System.Globalization.CultureInfo("en-U: 


// For culture-sensitive comparisons, use the String.Compare 

// overload that takes a StringComparison value. 

int i - String.Compare(first, second, StringComparison.CurrentCulti 
Console.WriteLine("Comparing in {0} returns {1}.", originalCulture 


// Change the current culture to Deutch-Deutchland. 

thread.CurrentCulture = new System.Globalization.CultureInfo("de-DE 
i = String.Compare(first, second, StringComparison.CurrentCulture) , 
Console.WriteLine("Comparing in {0} returns {1}.", thread.CurrentcCt 


// For culture-sensitive string equality, use either StringCompare 
// or the String.Equals overload that takes a StringComparison vali 
thread.CurrentCulture = originalCulture; 

bool b = String.Equals(first, second, StringComparison.CurrentCultt 
Console.WriteLine("The two strings {0} equal.", b == true ? "are" 


I5 

* Output: 
First sentence is Sie tanzen in die Straße. 
Second sentence is Sie tanzen in die Strasse. 
Comparing in en-US returns 0. 
Comparing in de-DE returns O0. 
The two strings are equal. 

Sy 
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下 面 的 示例 演示 如 何 使 用 具有 System.StringComparer 参数 的 静态 Array 方法 以 区 
分 区 域 性 的 方式 对 数组 中 的 字符 串 进行 排序 和 搜索 。 





class SortStringArrays 


( 


static void Main() 


( 


} 


string[] lines = new string[] 


@"c:\public\textfile.txt", 
@"c:\public\textFile. TXT", 
@"c:\public\Text.txt", 

@"c:\public\testfile2.txt" 


HH 


Console.WriteLine("Non-sorted order:"); 
foreach (string s in lines) 


i 
} 


Console.WriteLine("\n\rSorted order:"); 


Console.WriteLine(" ADEST 


// Specify Ordinal to demonstrate the different behavior. 
Array.Sort(lines, StringComparer.Ordinal); 


foreach (string s in lines) 


i 
} 


string searchString = @"c:\public\TEXTFILE.TXT"; 
Console.WriteLine("Binary search for {0}", searchString); 
int result = Array.BinarySearch(lines, searchString, String 
Showwhere<string>(lines, result); 


Console.WriteLine(" OW esM 


//Console.WriteLine("{0} {1}", result > 0 ? "Found" : "pid 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


// Displays where the string was found, or, if not found, 
// where it would have been located. 
private static void Showwhere<T>(T[] array, int index) 


( 


if (index « 0) 
// If the index is negative, it represents the bitwise 
// complement of the next larger element in the array. 
index - -index; 


Console.Write("Not found. Sorts between: "); 


if (index == 0) 

Console.Write("beginning of array and "); 
else 

Console.Write("[0) and ", array[index - 1]); 


if (index -- array.Length) 
Console.WriteLine("end of array."); 

else 
Console.WriteLine("{0}.", array[index]); 


} 
else 
Console.WriteLine("Found at index {0}.", index); 
} 
} 
} 
fs 
* Output: 
Non-sorted order: 
C: NpublicNtextfile.txt 
c:\public\textFile. TXT 
c:\public\Text.txt 
c:\public\testfile2.txt 
Sorted order: 
c:\public\Text.txt 
c:\public\testfile2.txt 
c:\public\textFile. TXT 
c:\public\textfile.txt 
Binary search for c:\public\TEXTFILE. TXT 
Found at index 2. 
74 





sd 
当 元 素 或 键 的 类 型 为 string 

时 ，System.Collections.Hashtable、System.Collections.Generic.Dictionary<TKey, 
TValue> 和 System.Collections.Generic.List<T> 等 集合 类 的 构造 男 数 具有 
System.StringComparer 人 参数。 通常 ， 上 应 尽 可 能 使 用 这 些 构 造 画 数 ， 并 指定 
Ordinal 或 OrdinallgnoreCase。 


请 参阅 
System.Globalization.Culturelnfo 
System.StringComparer 

FRE (CH 编程 指南 ) 

在 .NET Framework 中 比较 字符 串 
对 应 用 程序 进行 全 球 化 和 本 地 化 


如 何 : 拆 分 字符 串 (C# 编程 指南 ) 


下 面 的 代码 示例 演示 如 何 使 用 String.Split 方法 分 析 字 符 串 。 作 为 输入 ，Split 采用 

一 个 字符 数组 指示 哪些 字符 被 用 作 分 隔 符 。 本 示例 中 使 用 了 空格 、 逗 号、 句点 、 冒 
号 和 制 表 符 。 一 个 含有 这 些 分 隔 符 的 数组 被 传递 给 Split， 并 使 用 结果 字符 串 数 组 分 
别 显示 句子 中 的 每 个 单词 。 


class TestStringSplit 
{ 


static void Main() 


chach | sdelimaiterChars:=. E Mu NE ye 


string text = "one\ttwo three:four, five six seven"; 
System.Console.WriteLine("Original text: '{0}'", text); 


string[] words = text.Split(delimiterChars) ; 
System.Console.WriteLine("{0} words in text:", words.Lengtl 


foreach (string s in words) 


{ 
} 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


System.Console.WriteLine(s); 


j 


} 
/* Output: 
Original text: 'one two three:four,five six seven' 
7 words in text: 
one 
two 
three 
four 
five 
Six 
seven 





请 参阅 


C# 编程 指南 
字符 串 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


.NET Framework 正则 表达 式 


如 何 : 拆 分 字符 串 (CH 编程 指南 ) 506 


如 何 : 使 用 字符 串 方 法 搜索 字符 串 (C# 编程 指 两 ) 


string 类 型 〈 它 是 System.String 类 的 别名 ) 为 搜索 字符 串 的 内 容 提供 了 许多 有 用 
的 方法 。 


下 面 的 示例 使 用 IndexOf、LastlndexOf、StartsWith 和 EndsWith 方法 搜索 字符 
FR, 


class StringSearch 


( 


static void Main() 


1 


string str = "Extension methods have all the capabilities « 


// Write the string and include the quotation marks. 
System.Console.WriteLine("\"{O}\"", str); 


// Simple comparisons are always case sensitive! 
bool testi = str.StartsWith("extension"); 
System.Console.WriteLine("Starts with \"extension\"? {0}", 


// For user input and strings that will be displayed to the 
// use the StringComparison parameter on methods that have 
bool test2 - str.StartsWith("extension", System.StringComp: 
System.Console.WriteLine("Starts with \"extension\"? {0} (: 


bool test3 - str.EndsWith(".", System.StringComparison.Cur! 
System.Console.WriteLine("Ends with '.'? {0}", test3); 


// This search returns the substring between two strings, : 
// the first index is moved to the character just after the 
int first = str.IndexOf("methods") + "methods".Length; 

int last = str.LastIndexOf ("methods"); 

string str2 = str.Substring(first, last - first); 
System.Console.WriteLine("Substring between \"methods\" anc 


// Keep the console window open in debug mode 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


} 

Vix 

Output: 

"Extension methods have all the capabilities of regular static metl 
Starts with "extension"? False 

Starts with "extension"? True (ignoring case) 

Ends with '.'? True 

Substring between "methods" and "methods": ' have all the capabili! 
Press any key to exit. 

T 


sl 一 一 





小 


\ 


请 参阅 
C 编程 指南 
字符 串 (CH 编程 指南 ) 
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如 何 : 使 用 正则 表达 式 搜索 字符 串 (CH 编程 指南 ) 
LINQ and Strings 


如 何 : 使 用 字符 串 方 法 搜索 字符 串 〈《C# 编程 指南 ) 509 


如 何 : 使 用 正则 表达 式 搜 索 字 符 串 (C# 编程 指 两 ) 


可 以 使 用 System.Text.RegularExpressions.Regex 类 搜索 字符 串 。 这 些 搜索 有 的 非 
常 简 单 ， 有 的 复杂 到 需要 完全 使 用 正则 表达 式 。 以 下 是 使 用 Regex 类 搜索 字符 串 
的 两 个 示例 。 有 关 更 多 信息 ， 请 参见 .NET Framework 正则 表达 式 。 


以 下 代码 是 一 个 控制 台 应 用 程序 ， 用 于 对 数组 中 的 字符 串 执行 简单 的 不 区 分 大 小 写 
的 搜索 。 给 定 要 搜索 的 字符 串 和 包含 搜索 模式 的 字符 串 后 ， 静 态 方法 
Regex.IsMatch 将 执行 搜索 。 在 本 例 中 ， 使 用 第 三 个 参数 指示 忽略 大 小 写 。 有 关 更 


多 信息 ， 请 参见 System.Text.RegularExpressions.RegexOptions。 


class TestRegularExpressions 


( 


static void Main() 
string[] sentences - 


"CZ code", 

"Chapter 2: Writing Code", 
"Unicode", 

"no match here" 


H 

string sPattern = "code"; 

foreach (string s in sentences) 

i System.Console.Write("[0,24)", s); 


if (System.Text.RegularExpressions.Regex.IsMatch(s, sP: 


{ 
} 
else 


{ 
} 


System.Console.WriteLine(" (match for '{0}' found 


System.Console.WriteLine(); 
j 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


J 
} 
/* Output: 
C# code (match for 'code' found) 
Chapter 2: Writing Code (match for 'code' found) 
Unicode (match for 'code' found) 
no match here 





以 下 代码 是 一 个 控制 台 应 用 程序 ， 此 程序 使 用 正则 表达 式 验 证 数组 中 每 个 字符 串 的 
格式 。 验 证 要 求 每 个 字符 串 具 有 电话 号 码 的 形式 ， 即 用 短 划 线 将 数字 分 成 三 组 ， 前 
两 组 各 包含 三 个 数字 ， 第 三 组 包含 四 个 数字 。 这 是 使 用 正则 表达 式 \d{3}-\d{3}- 
\d{4}$ 完成 的 。 有 关 更 多 信息 ， 请 参见 正则 表达 式 语 言 - 快速 参考 。 


class TestRegularExpressionValidation 


( 


} 


static void Main() 


} 


string[] numbers = 


"123-555-0190", 
"444-234-22450", 
"690-555-0178", 
"146-893-232", 
"146-555-0122", 
"4007-555-0111", 
"407-555-0111", 
"407 -2-5555", 
3 
string sPattern = "A\\d{3}-\\d{3}-\\d{4}$"; 
foreach (string s in numbers) 
{ 
System.Console.Write("{0,14}", s); 


if (System.Text.RegularExpressions.Regex.IsMatch(s, sP: 


1 
} 
else 


{ 
} 


System.Console.WriteLine(" - valid"); 


System.Console.WriteLine(" - invalid"); 


j 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


/* Output: 


123-555-0190 - valid 
444-234-22450 - invalid 
690-555-0178 - valid 

146-893-232 - invalid 
146-555-0122 - valid 
4007-555-0111 - invalid 
407-555-0111 - valid 


407-2-5555 - invalid 
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System.Text.RegularExpressions.Regex 
C# 编程 指南 

FRE (CH 编程 指南 ) 

.NET Framework 正则 表达 式 

正则 表达 式 语言 - 快速 参考 


如 何 : 使 用 正则 表达 式 搜索 字符 串 (CH 编程 指南 ) 513 


如 何 : 确定 字符 串 是 否 表 示 数 值 (CH 编程 指南 ) 


若 要 确定 字符 串 是 否 是 指定 数值 类 型 的 有 效 表示 形式 ， 请 使 用 静态 的 TryParse 7; 
法 ， 该 方法 由 所 有 基 元 数值 类 型 以 及 诸如 DateTime 和 IPAddress 3x EN 3: 23e 
现 。 下 面 的 示例 演示 如 何 确定 “108" 是 否 为 有 效 的 int 类 型 。 


int i = 0; 
string s = "108"; 
bool result - int.TryParse(s, out i); //i now - 108 


如 果 字 符 串 包含 非 数 值 字符 或 者 所 包含 的 数值 对 于 指定 的 特定 类 型 而 言 太 大 或 太 
小 ，TryParse 都 将 返回 false 并 将 out 参数 设置 为 需 。 否 则 ， 它 将 返回 true， 并 且 
将 out 参数 设置 为 字符 串 的 数值 。 


y = 
Ej TER 


有 时 ， 虽 然 字符 串 可 能 只 包含 数值 字符 ， 对 于 您 使 用 的 TryParse 方法 所 属 的 类 
型 却 仍 然 会 无 效 。 例 如 ，“256” 对 于 byte 类 型 不 是 有 效 值 ， 但 对 于 int 类 型 有 
效 。"98.6" 对 于 int 类 型 不 是 有 效 值 ， 但 对 于 decimal 类 型 有 效 。 


下 面 的 示例 演示 如 何 对 long. byte 和 decimal 值 的 字符 串 表 示 形 式 使 用 
TryParse。 


string numString - "1287543"; //"1287543.0" will return false for : 
long numberi = 0; 
bool canConvert = long.TryParse(numString, out number1); 
if (canConvert -- true) 
Console.WriteLine("numberi now = {0}", numberi); 
else 
Console.WriteLine("numString is not a valid long"); 


byte number2 = 0; 
numString = "255"; // A value of 256 will return false 
canConvert = byte.TryParse(numString, out number2); 
if (canConvert == true) 

Console.WriteLine("number2 now = {0}", number2); 
else 

Console.WriteLine("numString is not a valid byte"); 


decimal number3 = 0; 
numString = "27.3"; //"27" is also a valid decimal 
canConvert = decimal.TryParse(numString, out number3); 
if (canConvert == true) 

Console.WriteLine("number3 now = {0}", number3); 
else 

Console.WriteLine("number3 is not a valid decimal"); 





可 靠 编程 


基 元 数值 类 型 还 实现 了 Parse 静态 方法 ， 此 方法 会 在 字符 串 不 是 有 效 数 字 时 引发 异 
常 。 TryParse 通常 更 加 有 效 ， 因 为 它 在 数字 无 效 时 只 是 返回 false。 


.NET Framework 安全 性 


请 始终 使 用 TryParse 或 Parse 方法 来 验证 用 户 在 文本 框 和 组 合 框 等 控件 中 输入 的 
内 容 。 


如 何 : 将 字 节 数组 转换 为 int (C£ 编程 指南 ) 

如 何 : 将 字符 串 转 换 为 数字 (CH 编程 指南 ) 

如 何 : 在 十 六 进 制 字符 串 与 数值 类 型 之 间 转 换 (CH 编程 指南 ) 
在 .NET Framework 中 分 析 数 值 字符 串 

.NET Framework 中 的 格式 化 类 型 
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如 何 : 确定 字符 串 是 否 表 示 数 值 (CH 编程 指南 ) 516 


如 何 : 将 字符 串 转 换 为 DateTime (CH 编程 指南 ) 


通常 程序 需要 支持 用 户 以 字符 串 值 的 形式 输入 日 期 。 若 要 将 基于 字符 串 的 日 期 转换 
为 System.DateTime 对 象 ， 可 以 使 用 Convert.ToDateTime(String) 方法 或 
DateTime.Parse(String) 静态 方法 ， 如 下 面 的 示例 所 示 。 


有 关 日 期 字符 串 的 更 多 示例 ， 请 参见 Convert.ToDateTime(String)。 


// Date strings are interpreted according to the current culture. 
// If the culture is en-US, this is interpreted as "January 8, 200t 
// but if the user's computer is fr-FR, this is interpreted as "Aut 
string date - "01/08/2008"; 

DateTime dt - Convert.ToDateTime(date); 

Console.WriteLine("Year: (0), Month: {1}, Day: {2}", dt.Year, dt.Mc 


// Specify exactly how to interpret the string. 
IFormatProvider culture = new System.Globalization.CultureInfo("fr. 


// Alternate choice: If the string has been input by an end user, \ 
// want to format it according to the current culture: 

// IFormatProvider culture = System.Threading.Thread.CurrentThread 
DateTime dt2 = DateTime.Parse(date, culture, System.Globalization.I 
Console.WriteLine("Year: {0}, Month: {1}, Day {2}", dt2.Year, dt2.! 


/* Output (assuming first culture is en-US and second is fr-FR): 
Year: 2008, Month: 1, Day: 8 
Year: 2008, Month: 8, Day 1 
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如 何 : 在 旧式 编码 与 Unicode 之 间 转 换 (CH 编程 
HA) 


在 C# 中， 内 存 中 的 所 有 字符 串 都 是 按 Unicode (UTF-16) 编码 的 。 将 数据 从 存储 器 
移动 到 string 对 象 中 后 ， 数 据 将 自动 转换 为 UTF-16。 如 果 数 据 久 包含 从 0 到 127 
的 ASCII 值 ， 则 此 转换 无 需 您 执行 任何 额外 的 工作 。 但 若 源 文本 包含 扩展 的 ASCII 
字 节 值 (128 到 255) ， 则 默认 情况 下 ， 将 根据 当前 代码 页 解释 扩展 字符 。 若 要 指 
定 应 该 根据 其 他 某 个 代码 页 解释 源 文本 ， 请 使 用 System.Text.Encoding 类 ， 如 下 
面 的 示例 所 示 。 


下 面 的 示例 演示 如 何 转 换 按 8 位 ASCII 编码 的 文本 文件 ， 此 转换 根据 Windows ft 
码 页 737 解释 源 文本 。 


class ANSIToUnicode 
t 


static void Main() 

{ 
// Create a file that contains the Greek work wWuxn (psyche: 
// code page 737 ((DOS) Greek). You can also create the fi. 
// to paste the characters into Microsoft Word and then "Se 
// (Greek) encoding. (Word will actually create a six-byte 
System.IO.File.WriteAllBytes(Q"greek.txt", new byte[] { Ox/ 


// Specify the code page to correctly interpret byte value: 
Encoding encoding - Encoding.GetEncoding(737); //(DOS) Gre« 
byte[] codePageValues = System.IO.File.ReadAllBytes(Q"greel 


// Same content is now encoded as UTF-16 
string unicodeValues - encoding.GetString(codePageValues); 


// Show that the text content is still intact in Unicode si 
// (Add a reference to System.Windows.Forms.dll) 
System.Windows.Forms.MessageBox.Show(unicodeValues); 


// Same content "yuyxr" is stored as UTF-8 
System.IO.File.WriteAllText(Q"greek unicode.txt", unicodeVv: 


// Conversion is complete. Show the bytes to prove the com 
Console.WriteLine("8-bit encoding byte values:"); 
foreach(byte b in codePageValues) 

Console.Write("{O:X}-", b); 


Console.WriteLine(); 

Console.WriteLine("Unicode values:"); 

string unicodeString - System.IO.File.ReadAllText("greek ur 

System.Globalization.TextElementEnumerator enumerator - 
System.Globalization.StringInfo.GetTextElementEnumerat¢ 

while(enumerator.MoveNext()) 


string s - enumerator.GetTextElement(); 
int i - Char.ConvertToUtf32(s, 0); 
Console.Write("([0:X)-", i); 

} 


Console.WriteLine(); 


// Keep the console window open in debug mode. 
Console.Write("Press any key to exit."); 
Console.ReadKey(); 


} 
Vix 
* Output: 

8-bit encoding byte values: 
AF-AC-AE-9E 
Unicode values: 
3C8-3C5-3C7-3B7 

EA 
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如 何 : 将 RTF 转换 为 纯 文 本 (CH 编程 指南 ) 


RTF 格式 是 Microsoft F 20 世纪 80 年 代 后 期 开发 的 一 种 文件 格式 ， 旨 在 实现 不 同 
操作 系统 之 间 的 文档 交换 。Microsoft Word 和 WordPad 都 可 以 读 写 RTF 文件 。 在 
NET Framework 中 ， 可 以 使 用 RichTextBox 控件 创建 支持 RTF BHR PL 
WYSIWIG 方式 将 格式 应 用 于 文本 的 字义 理 器 。 


也 可 以 使 用 RichTextBox 以 编程 方式 将 RTF 格式 代码 从 文档 中 移 除 ， 从 而 将 该 文 
档 转 换 为 纯 文 本 。 执 行 这 种 类 型 的 操作 无 需 在 Windows BAA HERA RIE. 


在 项 目 中 使 用 RichTextBox 控件 


1. 添加 对 System.Windows.Forms.dll 的 引用 。 
2. 为 System.Windows.Forms 命名 空间 添加 using 指令 〈 可 选 ) 。 


下 面 的 示例 将 示例 RTF 文件 转换 为 纯 文 本 。 文 件 包 含 RTF 格式 设置 (如 字体 信 
息 )， 四 个 Unicode 字符 和 四 个 扩展 的 ASCI 字符 。 代 码 示例 打开 文件 ， 将 其 内 容 
设置 为 RichTextBox， 当 RTF， 检 索 该 内 容 作 为 文本 ， 并 在 MessageBox 的 文本 和 
输出 该 文本 到 一 个 UTF-8 格式 的 文件 。 


MessageBox 和 输出 文件 包含 以 下 文本 : 


The Greek word for "psyche" is spelled wuxr. The Greek letters are 
These characters are from the extended ASCII character set (Window: 


= 





// Use NotePad to save the following RTF code to a text file in the 
// your .exe file for this project. Name the file test.rtf. 
/* 
{\rtfi\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\fO\fswiss\fcha) 
{\fi\fnil\fprgqi\fcharsetO Courier New; }{\f2\fswiss\fprq2\fcharseto 
{\colortbl ;NredONgreen128Nblue0O; \red0\greenO\blued; } 
{\*\generator Msftedit 5.41.21.2508; } 
Nviewkind4NuciNpardNfONfs20 The Ni Greek \i0 word for "psyche" is : 
These characters are from the extended Nb ASCII \bO character set | 
BA 
class ConvertFromRTF 
{ 
static void Main() 
{ 
// If your RTF file isn't in the same folder as the .exe f: 
// specify the path to the file in the following assignment 
string path = Q"test.rtf"; 


//Create the RichTextBox. (Requires a reference to System.\ 
System.Windows.Forms.RichTextBox rtBox = new System.Window: 


// Get the contents of the RTF file. When the contents of 1 
// stored in the string (rtfText), the contents are encodec 
string rtfText - System.IO.File.ReadAllText(path); 


// Display the RTF text. This should look like the content: 
System.Windows.Forms.MessageBox.Show(rtfText); 


// Use the RichTextBox to convert the RTF code to plain te 
rtBox.Rtf - rtfText; 
string plainText - rtBox.Text; 


// Display the plain text in a MessageBox because the cons 
// display the Greek letters. You should see the following 
// The Greek word for "psyche" is spelled yuyrj. The Greel 
Y encoded in Unicode. 

// | These characters are from the extended ASCII characte} 
// code page 1252): aaaa 
System.Windows.Forms.MessageBox.Show(plainText); 


// Output the plain text to a file, encoded as UTF-8\. 
System.IO.File.WriteAllText(Q"output.txt", plainText); 





RTF 字符 以 八 位 编码 。 但 是 ， 除 了 从 指定 的 代码 页 ， 扩 展 ASCII 字符 之 外 用 户 可 以 
指定 Unicode 字符 。 由 于 RichTextBox.Text 属性 为 string 类 型 ， 因 此 字符 按 
Unicode UTF-16 进行 编码 。 源 RTF 文档 中 的 所 有 扩展 的 ASCII 字符 和 Unicode 
字符 都 在 文本 输出 中 进行 了 正确 的 编码 。 
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如 果 使 用 File.WriteAlIText 方法 将 文本 写 入 磁盘 ， 则 文本 将 按 UTF-8 GEB 
序 标记 ) 进行 编码 。 


请 参阅 
System.Windows.Forms.RichTextBox 


字符 串 (CH 编程 指南 ) 


如 何 : 将 RTF 转换 为 纯 文本 (CH 编程 指南 ) 522 


类 型 (CH 编程 指南 ) 


类 型 、 变 量 和 值 
C4 是 一 种 强 类 型 语言 。 每 个 变量 和 常量 都 有 一 个 类 型 ， 每 个 计算 为 值 的 表达 式 也 
是 如 此 。 每 个 方法 签名 为 每 个 输入 参数 和 返回 值 指定 一 个 类 型 。.NET Framework 
类 库 定 义 了 一 组 内 置 数 值 类 型 以 及 表示 各 种 逻辑 构造 的 更 复杂 的 类 型 ， 例 如 文件 系 
统 、 网 络 连接 、 对 象 的 集合 和 数组 及 日 期 。 典 型 C# 程序 使 用 类 库 中 的 类 型 ， 还 使 
用 为 特定 于 该 程序 问题 域 的 概念 建 模 的 用 户 定义 类 型 。 

类 型 中 存储 的 信息 可 以 包括 : 

e 该 类 型 的 变量 所 需 的 存储 空间 。 

e. 该 类 型 可 以 表示 的 最 大 值 和 最 小 值 。 

e 该 类 型 包含 的 成 员 ( 方 法、 字段、 事件 等 ) 。 
该 类 型 所 继承 的 基 类 型 。 
将 在 运行 时 为 其 分 配 变量 内 存 的 位 置 。 
允许 的 运算 种 类 。 


编译 器 使 用 类 型 信息 确保 代码 中 执行 的 所 有 运算 都 是 类 型 安全 的 。 例 如 ， 如 果 声 明 
了 一 个 int 类 型 的 变量 ， 则 编译 器 允许 您 在 加 法 和 减法 运算 中 使 用 此 变量 。 如 果 党 
试 在 一 个 bool 类 型 的 变量 上 执行 相同 的 运算 ， 则 编译 器 会 产生 错误 ， 如 下 面 的 示 
例 所 示 : 


5 


int a P 
a + 2; //OK 


int b 


bool test - true; 


// Error. Operator '+' cannot be applied to operands of type 'int' 
int c = a + test; 


4 zem xm 
—. ~~ ae 
区 ERS 


请 C 和 C++ 开发 人 员 注 意 ， 在 C# 中 ，bool 不 能 转换 为 int。 


a 





编译 器 将 类 型 信息 作为 元 数据 散人 入 到 可 执行 文件 中 。 公 共 语 言 运行 时 (CLR) 会 在 运 
行 时 使 用 该 元 数据 ， 以 进一步 确保 它 在 分 配 和 回收 内 存 时 类 型 安全 。 


在 变量 声明 中 指定 类 型 


在 程序 中 声明 变量 或 常量 时 ， 必 须 指 定 其 类 型 或 者 使 用 关键 字 var 让 编译 器 可 以 推 
断 其 类 型 。 下 面 的 示例 演示 了 一 些 使 用 内 置 数值 类 型 和 复杂 的 用 户 定义 类 型 的 变量 


声明 : 


// Declaration only: 
float temperature; 
string name; 

MyClass myClass; 


// Declaration with initializers (four examples): 
char firstLetter = 'C'; 
var limit - 3; 
imel source = 1.0, 1, 2, 3, 4, 5 }; 
var query = from item in source 
where item <= limit 
select item; 


在 方法 签名 中 指定 方法 参数 和 返回 值 的 类 型 。 下 面 的 签名 中 演示 的 方法 需要 用 int 
作为 输入 参数 并 返回 一 个 字符 串 : 


public string GetName(int ID) 


if (ID « names.Length) 
return names[ID]; 
else 
return String.Empty; 


j 


private string[] names = { "Spencer", "Sally", "Doug" }; 


声明 了 一 个 变量 后 ， 不 能 使 用 新 类 型 重新 对 它 进 行 声 明 ， 也 不 能 向 它 赋 与 它 的 声明 
类 型 不 兼容 的 值 。 例 如 ， 不 能 声明 int， 然 后 向 它 赋予 布尔 值 rue。 但 是 ， 值 可 以 转 
换 为 其 他 类 型 ， 例 如 将 值 赋 给 新 变量 或 者 作为 方法 参数 传递 时 。 编 译 器 会 自动 执行 
不 会 导致 数据 丢失 的 类 型 转换 。 可 能 导致 数据 丢失 的 转换 需要 源 代码 内 有 强制 转 
换 。 


有 关 详 细 信 息 ， 请 参阅 强制 转换 和 类 型 转换 (CH 编程 指南 ) o 

内 置 类 型 

CH 提供 了 一 组 标准 的 内 置 数值 类 型 ， 用 来 表示 整数 、 浮 点 值 、 布 尔 表达 式 、 文 本 
字符 、 十 进 制 值 和 其 他 数据 类 型 。 还 有 内 置 的 string 和 object 类 型 。 您 可 以 在 任 


何 CH 程序 中 使 用 这 些 类 型 。 有 关内 置 类 型 的 更 多 信息 ， 请 参见 类 型 参考 表 (CHS 
考 ) 。 


自 定义 类 型 


您 可 以 使 用 struct, class, interface 和 enum 结构 创建 自己 的 自 定 义 类 型 。.NET 
Framework 类 库 本 身 是 Microsoft 提供 的 自 定义 类 型 的 集合 ， 您 可 以 在 自己 的 应 用 
程序 中 使 用 它们 。 默 认 情 况 下 ， 类 库 中 最 常用 的 类 型 在 所 有 C# 程序 中 均 可 用 。 而 
对 于 其 他 类 型 ， 则 仅 当 您 显 式 添 加 定义 这 些 类 型 的 程序 集 的 项 目 引 用 后 它们 才 可 
用 。 编 译 器 拥有 对 该 程序 集 的 引用 后 ， 才 可 以 在 源 代 码 中 声明 在 该 程序 集中 声明 的 
类 型 的 变量 (和 常量 ) 。 有 关 更 多 信息 ， 请 参见 .NET Framework Class 

Library (.NET Framework 类 库 ) 。 


通用 类 型 系统 
请 务必 了 解 有 关 .NET Framework 中 的 类 型 系统 的 以 下 两 个 基本 点 : 


e 它 支持 继承 原则 。 类 型 可 从 称 为 基 类 型 的 其 他 类 型 派生 。 派 生 类 型 继承 基 类 型 
的 方法 、 属 性 和 其 他 成 员 (存在 一 些 限制 ) 。 之 后 ， 基 类 型 可 从 某 些 其 他 类 型 
派生 ， 这 种 情况 下 ， 派 生 类 型 继承 其 层次 结构 中 这 两 个 基 类 型 的 成 员 。 包 括 如 
System.Int32 (C4 关键 字 : int) 等 内 置 数值 类 型 在 内 的 所 有 类 型 ， 最 终 都 是 
从 一 个 基 类 派生 得 到 的 ， 该 基 类 即 System.Object (CH 关键 字 : object) 。 这 
种 统一 的 类 型 层次 结构 称 为 常规 类 型 系统 (CTS)。 有 关 CH 中 的 继承 的 更 多 信 
息 ， 请 参见 继承 (CH 编程 指南 ) o 


e CTS 中 的 每 一 个 类 型 都 被 定义 成 了 值 类 型 或 引用 类 型 。 这 包括 .NET 
Framework 类 库 中 的 所 有 自 定义 类 型 以 及 您 自己 的 用 户 定义 类 型 。 使 用 关键 字 
struct 定义 的 类 型 是 值 类 型 ; MAAEMA KLM structs. HARKS 
class 定义 的 类 型 是 引用 类 型 。 引 用 类 型 和 值 类 型 有 不 同 的 编译 时 规则 和 不 同 
的 运行 时 行为 。 


下 图 演示 了 CTS 中 的 值 类 型 和 引用 类 型 之 间 的 关系 。 


引用 类 型 






Bt d dS min, 


值 类 型 


所 有 结构 ， 包 括 内 置 数 伞 
类 型 






所 有 枚 举 


CTS 中 的 值 类 型 和 引用 类 型 
8 注意 


可 以 看 到 ， 最 常用 的 类 型 都 组 织 到 了 System 命名 空间 。 但 是 ， 类 型 所 在 的 命 
空间 和 与 类 型 是 值 类 型 还 是 引用 类 型 没有 关系 。 


值 类 型 


值 类 型 是 从 派生 自 System.Object 的 System.ValueType 派生 的 。 派 生 自 
System.ValueType 的 类 型 在 CLR 中 有 特殊 行为 。 值 类 型 变量 直接 包含 它们 的 值 ， 
这 意味 着 内 存在 声明 变量 的 任意 上 下 文中 都 是 以 内 联 方 式 分配 的 。 值 类 型 变量 没 
单独 的 堆 分 配 或 垃圾 回收 开销 。 


值 类 型 分 为 两 个 类 别 : struct 和 enum。 
内 置 数 值 类 型 是 结构 ， 它 们 有 具有 可 以 访问 的 属性 和 方法 。 


// Static method on type Byte. 
byte b = Byte.MaxValue; 


但 是 ， 您 可 以 声明 它们 并 向 它们 赋值 ， 就 如 同 它们 是 简单 的 非 聚合 类 型 一 样 : 


byte num = OxA; 
int i = 5; 
char c = 'Z'; 


例如 ， 值 类 型 是 密封 的 ， 这 意味 着 您 不 能 从 System.Int32 派生 类 型 ， 并 且 不 能 定义 
一 个 结构 以 便 从 任何 用 户 定义 的 类 或 结构 继承 ， 因 为 结构 只 能 从 
System.ValueType 继承 。 但 是 ， 一 个 结构 可 以 实现 一 个 或 更 多 个 接口 。 可 以 将 结 
构 类 型 强制 转换 为 接口 类 型 ; 但 这 会 使 装 箱 操作 在 托管 堆 上 的 一 个 引用 类 型 对 象 内 
包装 该 结构 。 在 将 值 类 型 传递 给 将 System.Object 作为 输入 参数 的 方法 时 会 发 生 装 
箱 操作 。 有 关 详 细 信息 ， 请 参阅 装 箱 和 取消 装 箱 (C# 编程 指南 ) o 


可 以 使 用 struct 关键 字 创 建 自己 的 自 定义 值 类 型 。 通 常 ， 结 构 可 作为 一 小 组 相关 变 
量 的 容器 ， 如 下 面 的 示例 所 示 : 


public struct CoOrds 
public int x, y; 


public CoOrds(int pi, int p2) 


( 
x = pi; 
y = p2; 
} 
} 
有 关 结 构 的 更 多 信息 ， 请 参见 结构 (CH 编程 指南 ) o AX .NET Framework 中 的 
值 类 型 的 更 多 信息 ， 请 参见 常规 类 型 系统 。 


一 类 值 类 型 是 enum。 枚 举 定义 一 组 已 命名 的 整数 常量 。 例 如 ，.NET Framework 
类 库 中 的 System.IO.FileMode 枚 举 包 含 一 组 已 命名 的 整数 常量 ， 用 来 指定 点 如 何 
打开 文件 。 其 定义 方式 如 下 面 的 示例 所 示 : 


public enum FileMode 
{ 
CreateNew = 1, 
Create = 2, 
Open = 3, 
OpenOrCreate = 4, 
Truncate = 5, 
Append = 6, 


System.lO.FileMode.Create 常数 的 值 为 2. (Ae, EARRA, AMAaAA 
们 提供 更 多 信息 ， 因 此 最 好 使 用 枚 举 而 不 使 用 常量 文本 数字 。 有 关 详 细 信息 ， 请 参 
BR] System.IO.FileMode。 


所 有 枚 举 均 是 从 继承 自 System.ValueType 的 System.Enum 继承 的 。 所 有 适用 于 
结构 的 规则 同样 也 适用 于 枚 举 。 有 关 枚 举 的 更 多 信息 ， 请 参见 枚 举 类 型 (CH 编程 
指南 ) 。 


引用 类 型 


定义 为 类 、 委 托 、 数 组 或 接口 的 类 型 是 引用 类 型 。 在 运行 时 ， 当 您 声明 引用 类 型 的 
变量 时 ， 该 变量 会 一 直 包 含 值 null， 直 至 您 使 用 new 运算 符 显 式 创建 对 象 的 实例 ， 
或 者 为 该 变量 分 配 已 经 在 其 他 位 置 使 用 new 创建 的 对 象 , 如 下 所 示 : 


MyClass mc = new MyClass(); 
MyClass mc2 - mc; 


接口 必须 与 实现 它 的 类 对 象 一 起 初始 化 。 如 果 MyClass 实现 IMylnterface， 则 您 创 
& T IMylnterface 的 实例 ， 如 下 面 的 示例 所 示 : 


IMyInterface iface = new MyClass(); 


创建 对 象 时 ， 将 在 托管 堆 上 分 配 内 存 ， 变 量 只 保存 对 对 象 位 置 的 引用 。 对 于 托管 堆 
上 的 类 型 ， 在 CLR 的 自动 内 存 管理 功能 〈 称 为 "垃圾 回收 ") 对 它们 进行 分 配 和 回收 
时 都 需要 系统 开销 。 但 是 ， 也 对 垃圾 回收 进行 了 高 度 优化 ， 在 大 多 数 情况 下 它 不 会 
引起 性 能 问题 。 有 天 垃圾 回收 的 更 多 信息 ， 请 参见 自动 内 存 管理 。 


所 有 数组 都 是 引用 类 型 ， 即 使 其 元 素 是 值 类 型 也 不 例外 。 数 组 是 从 System.Array 
类 隐 式 派生 的 ， 但 可 以 通过 CH 提供 的 简化 语法 来 声明 和 使 用 它们 ， 如 下 面 的 示例 
所 示 : 


// Declare and initialize an array of integers. 
Int[] nums = { 1, 2, 3, 4,5}; 


// Access an instance property of System.Array. 
int len = nums.Length; 


引用 类 型 完全 支持 继承 。 创 建 类 时 ， 可 以 从 没有 定义 为 sealed 的 任何 其 他 接口 或 
类 继承 ， 而 其 他 类 则 可 以 从 您 创建 的 类 继承 并 重 写 虚 方 法 。 有 关 如 何 创建 自己 的 类 
的 更 多 信息 ， 请 参见 类 和 结构 (C# 编程 指南 ) 。 有 关 继 承 和 虚 方 法 的 更 多 信息 ， 

请 参见 继承 (CH 编程 指南 ) 。 


文本 值 类 型 


在 CH 中 ， 文 本 值 从 编译 器 接收 类 型 。 您 可 以 通过 在 数字 末尾 追加 一 个 字母 来 指定 
应 如 何 类 型 化 该 数字 文本 。 例 如 ， 若 要 指定 点 按 浮 点 数 来 处 理 值 4.56， 则 在 该 数字 
后 追加 一 个 P 或 “和 F”: 4.56f。 如 果 没 有 追加 字母 ， 则 编译 器 将 为 该 文本 推断 一 个 类 

型 。 有 关 可 以 使 用 字母 后 级 指定 的 类 型 的 更 多 信息 ， 请 参见 值 类 型 (C# 参考 ) 中 

各 个 类 型 的 参考 页 。 


由 于 文本 已 类 型 化 ， 且 所 有 类 型 最 终 都 是 从 System.Object 派生 ， 因 此 您 可 以 编写 
和 编译 如 下 所 示 的 代码 : 


string s = "The answer is " + 5.ToString(); 
// Outputs: "The answer is 5" 
Console.WriteLine(s); 


Type type - 12345.GetType( ); 
// Outputs: "System.Int32" 
Console.WriteLine(type); 


泛 型 关 型 


一 个 类 型 可 以 通过 一 个 或 多 个 类 型 参数 声明 ， 而 这 些 类 型 参数 作为 客户 端 代码 在 创 
建 该 类 型 的 实例 时 提供 的 实际 类 型 (具体 类 型 ) 的 占 位 符 。 这 种 类 型 称 为 “ 泛 型 类 
型 "。 例 如 ，.NET Framework 类 型 System.Collections.Generic.List<T> 有 一 个 类 
型 参数 ， 按 照 约定 该 类 型 参数 的 名 称 为 T。 在 创建 该 类 型 的 实例 时 ， 会 指定 列表 将 
包含 的 对 象 的 类 型 ， 例 如 字符 串 : 


List<string> strings = new List<string>(); 


使 用 类 型 参数 便 可 以 重复 使 用 相同 的 类 存放 任意 类 型 的 元 素 ， 而 不 必 将 每 个 元 素 都 
转换 为 对 象 。 泛 型 集合 类 称 为 “ 强 类 型 集合 "， 因 为 编译 器 知道 集合 中 元 素 的 特定 类 
型 ， 举 例 来 说 ， 如 果 党 试 向 上 面 示例 中 的 strings 对 象 添加 整数 ， 编 译 器 会 在 编译 
时 引发 错误 。 有 关 详 细 信 息 ， 请 参阅 泛 型 (CH 编程 指南 ) o 


隐 式 类 型 、 匿 名 类 型 和 可 以 为 null 的 类 型 


如 前 面 所 述 ， 您 可 以 使 用 关键 字 var 隐 式 类 型 化 一 个 局 部 变量 ( 非 类 成 员 ) 。 该 变 
量 在 编译 时 仍然 会 接收 一 个 类 型 ， 但 该 类 型 是 由 编译 器 提供 的 。 有 关 详 细 信息 ， 请 
参阅 隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) o 

某 些 情况 下 为 相关 值 的 简单 集合 创建 命名 类 型 是 不 方便 的 ， 因 为 这 些 相关 值 不 准备 
在 方法 边界 外 存储 或 传递 。 可 以 创建 匿名 类 型 来 实现 此 目的 。 有 关 更 多 信息 ， 请 参 
见 匿 名 类 型 (C# 编程 指南 ) 。 

普通 的 值 类 型 不 能 有 null 值 。 但 是 ， 可 以 通过 在 类 型 后 面 附加 ? 来 创建 可 以 为 null 
值 的 类 型 。 例 如 ，int? 是 一 个 也 可 以 具有 null 值 的 int 类 型 。 在 CTS 中 ， 可 以 为 

null 的 类 型 是 泛 型 结构 类 型 System.Nullable<T> 的 实例 。 在 向 其 数值 可 能 为 null 

的 数据 库 传 人 数据 和 从 中 传 出 数据 时 ， 可 以 为 null 的 类 型 尤其 有 用 。 有 关 详 细 信 

息 ， 请 参阅 可 以 为 null 的 类 型 (CH 编程 指南 ) 。 


相关 章节 


有 关 详 细 信 息 ， 请 参阅 下 列 主题 : 
e 强制 转换 和 类 型 转换 (CH 编程 指南 ) 
e 装 箱 和 取消 装 箱 (CH 编程 指南 ) 
e 使 用 类 型 dynamic (C£ 编程 指南 ) 
值 类 型 (C# 参考 ) 
e 引用 类 型 (C# 参考 ) 
类 和 结构 (C# 编程 指南 ) 
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e 匿名 类 型 (CH 编程 指南 ) 
e 泛 型 (CH 编程 指南 ) 
e Visual C£ 2010 Aj] 中 的 变量 与 表达 式 


CH iF E AUOD 


有 关 详 细 信 息 ， 请 A 参阅 Cz 语言 规 范 。 该 语言 vb 


aS i 
C4 参考 
C 编程 指南 
XML 数据 类 型 的 转换 
整 型 表 (CH 参考 ) 


类 型 (CH 编程 指南 ) 


soe C# 语法 和 用 法 的 权威 资料 。 
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强制 转换 和 类 型 转换 〈C# 编程 指南 ) 


由 于 CH 是 在 编译 时 静态 类 型 化 的 ， 因 此 变量 在 声明 后 就 无 法 再 次 声明 ， 或 者 无 法 
用 于 存储 其 他 类 型 的 值 ， 除 非 该 类 型 可 以 转换 为 变量 的 类 型 。 例 如 ， 不 存在 从 整数 
到 任意 字符 串 的 转换 。 因 此 ， 将 i 声明 为 整数 后 ， 就 无 法 将 字符 串 "Hello" 赋 予 它 ， 
如 下 面 的 代码 中 所 示 。 


int i; 
i = "Hello"; // Error: "Cannot implicitly convert type 'string' to 


Ae 


但 有 时 可 能 需要 将 值 复制 到 其 他 类 型 的 变量 或 方法 参数 中 。 例 如 ， 您 可 能 有 一 个 整 
数 变量 ， 您 需要 将 该 变量 传递 给 参数 类 型 化 为 double 的 方法 。 或 者 可 能 需要 将 类 
变量 赋 给 接口 类 型 的 变量 。 这 些 类 型 的 操作 称 为 "类 型 转换 ”。 在 C# 中 ， 可 以 执行 
以 下 几 种 类 型 的 转换 : 


e 隐 式 转换 : 由 于 该 转换 是 一 种 安全 类 型 的 转换 ， 不 会 导致 数据 丢失 ， 因 此 不 需 
要 任何 特殊 的 语法 。 例 如 ， 从 较 小 整数 类 型 到 较 大 整数 类 型 的 转换 以 及 从 派生 
类 到 基 类 的 转换 都 是 这 样 的 转换 。 


显 式 转换 (强制 转换 ) : 显 式 转换 需要 强制 转换 运算 符 。 在 转换 中 可 能 去 失信 
息 时 或 在 出 于 其 他 原因 转换 可 能 不 成 功 时 ， 必 须 进行 强制 转换 。 典 型 的 例子 包 
括 从 数值 到 精度 较 低 或 范围 较 小 的 类 型 的 转换 和 从 基 类 实例 到 派生 类 的 转换 。 


用 户 定义 的 转换 : 可 以 定义 一 些 特殊 的 方法 来 执行 用 户 定 义 的 转换 ， 从 而 使 不 
具有 基 类 -派生 类 关系 的 自 定义 类 型 之 间 可 以 显 式 和 隐 式 转换 。 有 关 更 多 信 
息 ， 请 参见 转换 运算 符 (CH 编程 指南 ) o 


使 用 帮助 程序 类 的 转换 : 若 要 在 不 兼容 的 类 型 之 间 进 行 转 换 ， 例 如 在 整数 与 
System.DateTime 对 象 之 间 转 换 ， 或 者 在 十 六 进 制 字符 串 与 字 节 数组 之 间 转 
换 ， 则 可 以 使 用 System.BitConverter 类 、System.Convert 类 和 内 起 数 值 类 型 
的 Parse 方法 ， 例 如 Int32.Parse。 有 关 更 多 信息 ， 请 参见 如 何 : 将 字 节 数组 
转换 为 int (CH 编程 指南 ) 、 如 何 : 将 字符 串 转 换 为 数字 (CH 编程 指南 ) 和 
如 何 : 在 十 六 进 制 字 符 串 与 数值 类 型 之 间 转 换 (CH 编程 指南 ) o 





隐 式 转换 


对 于 内 置 数值 关 型 ， 如 果 要 存储 的 值 无 需 截断 或 四 舍 五 入 即 可 适应 变量 ， 则 可 以 进 
行 隐 式 转换 。 例 如 ，long 类 型 的 变量 (8 字 节 整数 ) 能 够 存储 int (在 32 位 计算 机 
上 为 4 字 节 ) 可 存储 的 任何 值 。 在 下 面 的 示例 中 ， 编 译 器 先 将 右 侧 的 值 隐 式 转换 为 
long 类 型 ， 再 将 它 赋 给 bigNum。 


// Implicit conversion. num long can 

// hold any value an int can hold, and more! 
int num = 2147483647; 

long bigNum - num; 


有 关 所 有 隐 式 数值 转换 的 完整 列表 ， 请 参见 隐 式 数值 转换 表 (CES), 


对 于 引用 类 型 ， 隐 式 转换 始终 存在 于 从 一 个 类 转换 为 该 类 的 任何 一 个 直接 或 间接 的 
基 类 或 接口 的 情况 。 由 于 派生 类 始终 包含 基 类 的 所 有 成 员 ， 因 此 不 必 使 用 任何 特殊 


语法 。 


Derived d = new Derived(); 
Base b - d; // Always OK. 


显 式 转换 


但 是 ， 如 果 进 行 转换 可 能 会 导致 信息 丢失 ， 则 编译 器 会 要 求 执行 显 式 转换 ， 显 式 转 
换 也 称 为 "强制 转换 ”。 强 制 转换 是 显 式 通知 编译 器 您 打算 进行 转换 且 您 知道 可 能 会 
发 生 数 据 丢 失 的 一 种 方式 。 若 要 执行 强制 转换 ， 请 在 要 转换 的 值 或 变量 前 面 的 圆 括 
号 中 指定 要 强制 转换 到 的 类 型 。 下 面 的 程序 将 double 强制 转换 为 int。 如 不 强制 转 
换 则 该 程序 不 会 进行 编译 。 
class Test 
static void Main() 

double x - 1234.7; 

int a; 

// Cast double to int. 

a = (int)x; 

System.Console.WriteLine(a); 


j 


} 
// Output: 1234 


有 关 支 持 的 显 式 数值 转换 的 列表 ， 请 参见 显 式 数值 转换 表 (CHESS) 。 
对 于 引用 类 型 ， 如 果 需 要 从 基 类 型 转换 为 派生 类 型 ， 则 必须 进行 显 式 强制 转换 : 


// Create a new derived type. 
Giraffe g - new Giraffe(); 


// Implicit conversion to base type is safe. 
Animal a - g; 


// Explicit conversion is required to cast back 

// to derived type. Note: This will compile but will 
// throw an exception at run time if the right-side 
// object is not in fact a Giraffe. 

Giraffe g2 - (Giraffe) a; 


引用 类 型 之 间 的 强制 转换 操作 不 会 更 改 基础 对 象 的 运行 时 类 型 ; 它 只 更 改 用 作对 该 
对 象 的 引用 的 值 的 类 型 。 有 关 更 多 信息 ， 请 参见 SAE (CH 编程 指南 ) 。 


运行 时 的 类 型 转换 异 单 


在 某 些 引 用 类 型 转换 中 ， 编 译 器 无 法 确定 强制 转换 是 否 会 有 效 。 正 确 进行 编译 的 强 
制 转换 操作 有 可 能 在 运行 时 失败 。 如 下 面 的 示例 所 示 ， 类 型 强制 转换 在 运行 时 失败 
将 导致 引发 InvalidCastException。 


using System; 


class Animal 


{ 
public void Eat() { Console.WriteLine("Eating."); } 


public override string ToString() 


{ 
} 


class Reptile : Animal { } 
class Mammal : Animal { } 


return "I am an animal."; 


class UnSafeCast 


{ 
static void Main() 
{ 
Test(new Mammal()); 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
static void Test(Animal a) 
// Cause InvalidCastException at run time 
// because Mammal is not convertible to Reptile. 
Reptile r = (Reptile)a; 
} 
} 


CH 提供 is 和 as 运算 符 ， 使 您 可 以 在 实际 执行 强制 转换 之 前 测试 兼容 性 。 有 关 更 多 
信息 ， 请 参见 如 何 : 使 用 as 和 is 运算 符 安全 地 进行 强制 转换 (CH 编程 指南 ) o 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 


重要 章节 


More About Variables 在 Beginning Visual C# 2010 


请 参阅 


MSDN C# 编程 指南 & 参考 手册 2015 


C# 编程 指南 

类 型 (CH 编程 指南 ) 

() 运算 符 (C# 参考 ) 

explicit (C£ 参考 ) 

implicit (C£ 参考 ) 

转换 运算 符 (CH 编程 指南 ) 

Generalized Type Conversion 

Exported Type Conversion 

如 何 : 将 字符 串 转 换 为 数字 (CH 编程 指南 ) 


强制 转换 和 类 型 转换 (CH 编程 指南 ) 
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FRAN sess (CH 编程 指南) 


装 箱 是 将 值 类 型 转换 为 object 类 型 或 由 此 值 类 型 实现 的 任何 接口 类 型 的 过 程 。 当 
CLR 对 值 类 型 进行 装 箱 时 ， 会 将 该 值 包装 到 System.Object 内 部 ， 再 将 后 者 存储 在 
HEEL, 取消 装 箱 将 从 对 象 中 提取 值 类 型 。 装 箱 是 隐 式 的 ; 取消 装 箱 是 显 式 的 。 
Na 
为 一 个 对 象 。 


在 下 面 的 示例 中 ， 将 整 型 变量 i 进行 了 装 箱 并 分 配给 对 象 0。 


int ah = T23; 
// The following line boxes i. 
object o = i; 


然后 ， 可 以 将 对 象 o 取消 装 箱 并 分 配给 整 型 变量 i : 


o 


123; 
(int)o; // unboxing 


以 下 示例 演示 如 何在 C# 中 使 用 装 箱 。 


// String.Concat example. 

// String.Concat has many versions. Rest the mouse pointer on 
// Concat in the following statement to verify that the version 
// that is used here takes three object arguments. Both 42 and 
// true must be boxed. 
Console.WriteLine(String.Concat("Answer", 42, true)); 


// List example. 

// Create a list of objects to hold a heterogeneous collection 
// of elements. 

List<object> mixedList = new List<object>(); 


// Add a string element to the list. 
mixedList.Add("First Group:"); 


// Add some integers to the list. 
for (int j 1; j < 5; j++) 


{ 
// Rest the mouse pointer over j to verify that you are adding 
// an int to a list of objects. Each element j is boxed when 
// you add j to mixedList. 
mixedList.Add(j); 

} 


// Add another string and more integers. 


mixedList.Add("Second Group:"); 
for (nt J= S j 10; J+) 
{ 


} 


// Display the elements in the list. Declare the loop variable by 
// using var, so that the compiler assigns its type. 
foreach (var item in mixedList) 


mixedList.Add(j); 


{ 
// Rest the mouse pointer over item to verify that the element: 
// of mixedList are objects. 
Console.WriteLine(item); 

j 


// The following loop sums the squares of the first group of boxed 
// integers in mixedList. The list elements are objects, and cannot 
// be multiplied or added to the sum until they are unboxed. The 
// unboxing must be done explicitly. 

var sum - 0; 

for (var j = 1; j < 5; j++) 


{ 
// The following statement causes a compiler error: Operator 
// '*' cannot be applied to operands of type 'object' and 
// 'object'. 
//sum += mixedList[j] * mixedList[j]); 
// After the list elements are unboxed, the computation does 
// not cause a compiler error. 
sum += (int)mixedList[j] * (int)mixedList[j]; 
} 
// The sum displayed is 30, the sum of 1 + 4+ 9 -* 16. 
Console.WriteLine("Sum: " + sum); 
// Output: 


// Answer42True 
// First Group: 
MU al 
// 2 
N S 
// 4 
// Second Group: 


6 

7 

8 
// 9 

Sum: 30 











性 能 
相对 于 简单 的 赋值 而 言 ， 装 箱 和 取消 装 箱 过 程 需要 进行 大 量 的 计算 。 对 值 关 型 进行 


装 箱 时 ， 必 须 分 配 并 构造 一 个 新 对 象 。 取 消 装 箱 所 需 的 强制 转换 也 需要 进行 大 量 的 
计算 ， 只 是 程度 较 轻 。 有 关 更 多 信息 ， 请 参见 性 能 。 


Yok Ate 


«^H 


装 箱 用 于 在 垃圾 回收 堆 中 存储 值 类 型 。 装 箱 是 值 类 型 到 object 类 型 或 到 此 值 类 型 
所 实现 的 任何 接口 类 型 的 隐 式 转换 。 对 值 类 型 装 箱 会 在 堆 中 分 配 一 个 对 象 实例 ， 并 
将 该 值 复制 到 新 的 对 象 中 。 


请 看 以 下 值 类 型 变量 的 声明 : 


int i = 123; 


以 下 语句 对 变量 | rU FIT RRI : 


// Boxing copies the value of i into object o. 
object o = i; 


此 语句 的 结果 是 在 堆栈 上 创建 对 象 引 用 o， 而 在 堆 上 则 引用 int 类 型 的 值 。 该 值 是 


赋 给 变量 i 的 值 类 型 值 的 一 个 副本 。 下 图 说 明了 两 个 变量 1 和 o 之 间 的 差异 。 


在 堆栈 上 在 堆 上 
i 


Int i2123; 


o 
NN — 


object o=i; 


C i X8) 


还 可 以 像 下 面 的 示例 一 样 执行 显 式 装 箱 ， 但 显 式 装 箱 从 来 不 是 必需 的 : 


Int i = 123; 
object o = (object)i; // explicit boxing 


3 BH 


此 示例 使 用 装 箱 将 整 型 变量 i 转换 为 对 象 0o。 这 样 一 来 ， 存 储 在 变量 i 中 的 值 就 从 
123 更 改 为 456。 该 示例 表明 原始 值 类 型 和 装 箱 的 对 象 使 用 不 同 的 内 存 位 置 ， 因 此 
能 够 存储 不 同 的 值 。 


class TestBoxing 


{ 
static void Main() 
( . H 
int i - 123; 
// Boxing copies the value of i into object o. 
object o = i; 
// Change the value of i. 
i = 456; 
// The change in i does not effect the value stored in o. 
System.Console.WriteLine("The value-type value = (0j", i); 
System.Console.WriteLine("The object-type value = {0}", o), 
j 
} 
/* Output: 
The value-type value = 456 
The object-type value = 123 
pu 


do oo 


取消 委 


IH a FHM object 类 型 到 值 类 型 或 从 接口 类 型 到 实现 该 接口 的 值 类 型 的 显 式 转 
换 。 取 消 装 箱 操作 包括 : 


e 检查 对 象 实例 ， 以 确保 它 是 给 定 值 类 型 的 装 箱 值 。 
e. 将 该 值 从 实例 复制 到 值 类 型 变量 中 。 

下 面 的 语句 演示 装 箱 和 取消 装 箱 两 种 操作 : 

int i = 123; // a value type 


object o = i; // boxing 
int j = (int)o; // unboxing 


在 堆栈 上 在 堆 上 


int i123; 


o CH i 44a) 
| Ce 
object o=i; 


j 


int j=(int) 0; 

取消 装 箱 转换 

要 在 运行 时 成 功 取消 装 箱 值 类 型 ， 被 取消 装 箱 的 项 必须 是 对 一 个 对 象 的 引用 ， 该 对 
象 是 先前 通过 装 箱 该 值 类 型 的 实例 创建 的 。 尝 试 取消 装 箱 null 会 导致 


NullReferenceException。 党 试 取消 装 箱 对 不 兼容 值 类 型 的 引用 会 导致 
InvalidCastException。 


下 面 的 示例 演示 无 效 的 取消 装 箱 及 引发 的 InvalidCastException。 使 用 try 和 
catch， 在 发 生 错 误 时 显示 错误 信息 。 


class TestUnboxing 





t 
static void Main() 
{ 
intet i= 1297 
object o = i; // implicit boxing 
try 
int j = (short)o; // attempt to unbox 
System.Console.WriteLine("Unboxing OK."); 
catch (System.InvalidCastException e) 
System.Console.WritelLline("([0) Error: Incorrect unboxing 
} 
} 
} 
此 程序 输出 : 
Specified cast is not valid.Error: Incorrect unboxing. 
如 果 将 下 列 语句 : 


int j = (short) o; 


AH: 


int j = (int) o; 


将 执行 转换 ， 并 将 得 到 以 下 输出 : 
Unboxing OK. 


$m <+ 
CH BAG 
有 关 详 细 信 息 ， 请 e 参阅 C# i TE B. 该 语 & AG Jb 2D 是 C# te SFA AEM A RAK. 


相关 章节 


更 多 相关 信息 : 

e 引用 类 型 

。 值 关 型 
CH 语言 规范 


有 关 详 细 信 息 ， i8 € $2] C# i TE B. 该 语 言 规范 Jb D 是 C# j te 知 法 和 用 法 的 权威 资料 。 


请 参阅 


C 编程 指南 


(& Fd 3€ dynamic (C# 编程 指南 ) 


Visual C£ 2010 引入 了 一 个 新 类 型 dynamic。 该 类 型 是 一 种 静态 类 型 ， 但 类 型 为 
dynamic 的 对 象 会 跳 过 静态 类 型 检查 。 大 多 数 情 况 下 ， 该 对 象 就 像 具 有 类 型 
object 一 样 。 在 编译 时 ， 将 假定 类 型 化 为 dynamic 的 元 素 支持 任何 操作 。 因 此 ， 
您 不 必 考 虑 对 象 是 从 COM API、 从 动态 语言 〈 例 如 IronPython) 、 从 HTML 文档 
对 象 模型 (DOM)、 从 反射 还 是 从 程序 中 的 其 他 位 置 获取 自己 的 值 。 但 是 ， 如 果 代 码 
无 效 ， 则 在 运行 时 会 捕获 到 错误 。 


例如 ， 如 果 以 下 代码 中 的 实例 方法 exampleMethod1 只 有 一 个 形 参 ， 则 编译 器 会 将 
对 该 方法 的 第 一 个 调用 ec.exampleMethod1(10, 4) 识别 为 无 效 ， 原 因 是 它 包 含 两 
个 实 参 。 该 调用 将 导致 编译 器 错误 。 编 译 器 不 会 检查 对 该 方法 的 第 二 个 调用 
dynamic ec.exampleMethod1(10, 4)， 原 因 是 dynamic ec 的 类 型 为 dynamic, 
此 ， 不 会 报告 编译 器 错误 。 但 是 ， 该 错误 不 会 被 无 限期 疏忽 。 它 将 在 运行 时 被 捕 
获 ， 并 导致 运行 时 异常 。 


static void Main(string[] args) 
{ 
ExampleClass ec = new ExampleClass(); 
// The following call to exampleMethodi causes a compiler erroi 
// if exampleMethodi has only one parameter. Uncomment the Line 
// to see the error. 
//ec.exampleMethod1(10, 4); 


dynamic dynamic ec - new ExampleClass(); 

// The following line is not identified as an error by the 
// compiler, but it causes a run-time exception. 

dynamic ec.exampleMethodi1(10, 4); 


// The following calls also do not cause compiler errors, whetl 
// appropriate methods exist or not. 

dynamic ec.someMethod("some argument", 7, null); 

dynamic ec.nonexistentMethod(); 





class ExampleClass 


{ 
public ExampleClass() { } 
public ExampleClass(int v) { } 
public void exampleMethodi(int i) { } 
public void exampleMethod2(string str) { } 
j 


在 这 些 示例 中 ， 编 译 器 的 作用 是 将 有 关 每 个 语句 的 预期 作用 的 信息 一 起 打包 到 类 型 
化 为 dynamic 的 对 象 或 表达 式 。 在 运行 时 ， 将 对 存储 的 信息 进行 检查 ， 并 且 任 何 
无 效 的 语句 将 会 导致 运行 时 异常 。 

大 多 数 动态 操作 的 结果 是 其 本 身 dynamic。 例 如 ， 如 果 将 鼠标 指针 放 在 以 下 示例 中 
使 用 的 testSum 上 ， 则 IntelliSense 将 显示 类 型 “( 局 部 变量 )dynamic testSum", 


dynamic d = 1; 

var testSum = d + 3; 

// Rest the mouse pointer over testSum in the following statement. 
System.Console.WriteLine(testSum); 


HE c ERI 


结果 不 是 dynamic 的 操作 包括 从 dynamic 到 另 一 种 类 型 的 转换 ， 以 及 包括 类 型 为 
dynamic 的 参数 的 构造 画 数 调用 。 例 如 ， 以 下 声明 中 testlnstance 的 类 型 为 
ExampleClass， 而 不 是 dynamic。 


var testInstance = new ExampleClass(d); 
下 一 节 "“ 转 换 " 中 显示 了 转换 示例 。 


转换 


动态 对 象 和 其 他 类 型 之 间 的 转换 非常 简单 。 这 样 ， 开 发 人 员 将 能 够 在 动态 行为 和 非 
动态 行为 之 间 切 换 。 


任何 对 象 都 可 隐 式 转换 为 动态 类 型 ， 如 下 面 的 示例 所 示 。 


dynamic d1 = 7; 

dynamic d2 - "a string"; 

dynamic d3 - System.DateTime.Today; 

dynamic d4 = System.Diagnostics.Process.GetProcesses(); 


反之 ， 隐 式 转换 也 可 动态 地 应 用 于 类 型 为 dynamic 的 任何 表达 式 。 


int i - d1; 

string str - d2; 

DateTime dt - d3; 
System.Diagnostics.Process[] procs = d4; 


使 用 类 型 为 dynamic 的 参数 重 载 决策 


如 果 方 法 调用 中 的 一 个 或 多 个 参数 具有 类 型 dynamic， 或 者 方法 调用 的 接收 方 的 类 
型 为 dynamic， 则 会 在 运行 时 (而 不 是 在 编译 时 ) 进行 重 载 决 策 。 在 下 面 的 示例 
中 ， 如 果 唯 一 可 访问 的 exampleMethod2 方法 定义 为 接受 字符 串 参 数 ， 则 将 d1 作 
为 参数 发 送 不 会 导致 编译 器 错误 ， 但 却 会 导致 运行 时 异常 。 重 载 决 策 之 所 以 会 在 运 
行 时 失败 ， 原 因 是 d1 的 运行 时 类 型 为 int， 而 exampleMethod2 需要 字符 串 。 


// Valid ， 
ec.exampleMethod2("a string"); 


// The following statement does not cause a compiler error, even tl 
// dynamic. A run-time exception is raised because the run-time ty; 
ec.exampleMethod2(d1); 

// The following statement does cause a compiler error. 
//ec.exampleMethod2(7); 


El — B 





动态 语言 运行 时 


动态 语言 运行 时 (DLR) 是 .NET Framework 4 中 的 一 个 新 API。 它 提供 了 支持 CH 
中 的 dynamic 类 型 的 基础 结构 ， 还 提供 II IronPython 和 IronRuby 等 动态 编 
程 语言 的 实现 。 有 关 DLR 的 更 多 信息 ， 请 参见 动态 语言 运行 时 概述 。 


COM 互 操作 


Visual C£ 2010 包括 若干 功能 ， 这 些 功能 改善 了 与 COMAPI (例如 Office 自动 化 
API) 的 互 操作 体验 。 这 些 改进 之 处 包括 dynamic 类 型 以 及 命名 参数 和 可 选 参数 的 
使 用 。 


通过 将 类 型 指定 为 object， 许 多 COM 方法 都 允许 参数 类 型 和 返回 类 型 发 生变 化 。 
这 样 ， 就 必须 显 式 强 制 转换 值 ， 以 便 与 C# 中 的 强 类 型 变量 保持 协调 。 如 果 使 用 
/link (C# Compiler Options) 选项 进行 编译 ， 则 dynamic 类 型 的 引入 使 您 能 够 将 
COM 签名 中 出 现 的 object 实例 看 作 dynamic 类 型 ， 从 而 避免 了 大 量 的 强制 转 

换 。 LI 如 ， 下 面 的 语句 对 比 了 在 使 用 dynamic 类 型 和 不 使 用 dynamic 类 型 的 情况 
下 如 何 访问 Microsoft Office Excel 电子 表格 中 的 单元 格 。 


// Before the introduction of dynamic. 
((Excel.Range)excelApp.Cells[1, 1]).Value2 = "Name"; 
Excel.Range range2008 = (Excel.Range)excelApp.Cells[1, 1]; 


// After the introduction of dynamic, the access to the Value pr 
// the conversion to Excel.Range are handled by the run-time COM b: 
excelApp.Cells[1, 1].Value = "Name"; 

Excel.Range range2010 = excelApp.Cells[1, 1]; 


到 Eee 


相关 主题 





dynamic (C£ 参考 ) 描述 dynamic 关键 字 的 用 法 。 
提供 有 关 DLR 的 概述 ，DLR 是 一 种 运行 时 环 
动态 语言 运行 时 概述 境 ， 它 将 一 组 适用 于 动态 语言 的 服务 添加 到 公共 
j3 Bik 7H (CLR). 


演练 : 创建 和 使 用 动态 对 ”提供 了 有 关 如 何 创建 自 定义 动态 对 象 以 及 创建 访 
& (C# 和 Visual Basic) 问 IronPython 库 的 对 象 的 分 步 说 明 。 


如 何 : 通过 使 用 Visual CH ”演示 如 何 创 建 一 个 项 目 ， 该 项 目 使 用 了 命名 参数 
功能 访问 Office 互 操作 对 ”和 可 选 人 参数、dynamic 类 型 以 及 可 简化 对 Office 
R (CH 编程 指南 ) API 对 象 的 访问 的 其 他 增强 功能 。 


如 何 : 使 用 as 和 is 运算 符 安 全 地 进行 强制 转换 
(CH 编程 指南 ) 


由 于 对 象 是 多 态 的 ， 因 此 基 类 类 型 的 变量 可 以 保存 派生 类 型 。 若 要 访问 派生 类 型 的 
方法 ， 需 要 将 值 强制 转换 回 该 派生 类 型 。 不 过 ， 在 这 些 情况 下 ， 如 果 只 尝试 进行 简 
单 的 强制 转换 ， 会 导致 引发 InvalidCastException 的 风险 。 这 就 是 CH 提供 is 和 as 
运算 符 的 原因 。 您 可 以 使 用 这 两 个 运算 符 来 测试 强制 转换 是 否 会 成 功 ， 而 没有 引发 
异常 的 风险 。 通 常 ，as 运算 符 更 高 效 一 些 ， 因 为 如 果 可 以 成 功 进 行 强制 转换 ， 它 会 
实际 返回 强制 转换 值 。 而 is 运算 符 只 返回 一 个 布尔 值 。 因 此 ， 如 果 只 想 确 定 对 象 的 
类 型 ， 而 无 需 对 它 进行 实际 强制 转换 ， 则 可 以 使 用 is 运算 符 。 


下 面 的 示例 演示 如 何 使 用 is 和 as 运算 符 从 一 个 引用 类 型 强制 转换 为 另 一 个 引用 类 
型 ， 而 没有 引发 异常 的 风险 。 此 示例 还 演示 如 何 对 as 运算 符 使 用 可 以 为 null 值 的 
类 型 。 


class SafeCasting 


( 


class Animal 


{ 
public void Eat() ( Console.WriteLine("Eating."); } 


public override string ToString() 


{ 
j 


class Mammal : Animal ( } 
class Giraffe : Mammal { } 


return "I am an animal."; 


class SuperNova { } 


static void Main() 


{ 
SafeCasting app = new SafeCasting(); 


// Use the is operator to verify the type. 
// before performing a cast. 

Giraffe g - new Giraffe(); 
app.UselsOperator(g); 


// Use the as operator and test for null 
// before referencing the variable. 
app.UseAsOperator(g); 


// Use the as operator to test 
// an incompatible type. 
SuperNova sn = new SuperNova(); 
app.UseAsOperator(sn); 


// Use the as operator with a value type. 
// Note the implicit conversion to int? in 
// the method body. 

int i = 5; 

app.UseAsWithNullable(i); 


double d - 9.78654; 
app.UseAsWithNullable(d); 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 


} 
void UseIsOperator (Animal a) 
{ 
if (a is Mammal) 
{ 
Mammal m = (Mammal)a; 
m.Eat(); 
} 
} 
void UseAsOperator (object o) 
{ 
Mammal m = o as Mammal; 
if (m != null) 
{ 
Console.WriteLine(m.ToString()); 
} 
else 
{ 
Console.WriteLine("{0} is not a Mammal", o.GetType().N: 
} 
} 
void UseAsWithNullable(System.ValueType val) 
{ 


int? j = val as int?; 
if (j != null) 


{ 
Console.WriteLine(j); 
} 
else 
{ 
Console.WriteLine("Could not convert " + val.ToString(. 
} 
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请 参阅 

类 型 (CH 编程 指南 ) 

强制 转换 和 类 型 转换 (CH 编程 指南 ) 
可 以 为 null 的 类 型 (CH 编程 指南 ) 


如 何 : 使 用 as 和 is 运算 符 安全 地 进行 强制 转换 (CH 编程 指南 ) 548 


如 何 : 将 字 节 数组 转换 为 int. (CH 编程 指南 ) 


此 示例 演示 如 何 使 用 BitConverter 类 将 字 节 数组 转换 为 int 并 返回 字 节 数组 。 例 
如 ， 在 从 网 络 读 取 字 节 之 后 ， 可 能 需要 将 字 节 转换 为 内 置 数 据 类 型 。 除 了 示例 中 的 
ToInt32(Byte[], Int32) 方法 之 外 ， 下 表 列 出 了 BitConverter 类 中 将 字 节 (来 自 字 节 
数组 ) 转换 为 其 他 内 置 类 型 的 方法 。 


返回 类 型 方法 

bool ToBoolean(Byte[], Int32) 
char ToChar(Byte[], Int32) 
double ToDouble(Byte[], Int32) 
short ToInt16(Byte[], Int32) 
int ToInt32(Byte[], Int32) 
long Tolnt64(Bytel], Int32) 
float ToSingle(Byte[], Int32) 
ushort ToUInt16(Byte[], Int32) 
uint ToUInt32(Byte[], Int32) 
ulong ToUInt64(Byte[], Int32) 


此 示例 实例 化 字 节 数组 ， 并 在 计算 机 结构 为 littleeendian 的 情况 下 反 转 数组 (BIS 
先 存储 最 低 有 效 字 节 ) ， 然 后 调用 Tolnt32(Byte[], Int32) 方法 以 将 数组 中 的 四 个 字 
节 转 换 为 int. Tolnt32(Byte[], Int32) 的 第 二 个 参数 指定 字 节 数组 的 起 始 索引 。 


= = 
Eg TERR 


输出 可 能 会 根据 计算 机 结构 的 endian 设置 而 不 同 。 


byte[] bytes = (0, 0, 0, 25 Y; 


// If the system architecture is little-endian (that is, little en 
// reverse the byte array. 
if (BitConverter.IsLittleEndian) 

Array.Reverse(bytes); 


int i - BitConverter.ToInt32(bytes, 0); 
Console.WriteLine("int: [0)", i); 
77 Output: int: 25 


E E 








在 此 示例 中 ， 调 用 BitConverter 类 的 GetBytes(Int32) 方法 以 将 int 转换 为 字 节 数 
组 。 

8 注意 

输出 可 能 会 根据 计算 机 结构 的 endian 设置 而 不 同 。 


byte[] bytes = BitConverter.GetBytes(201805978); 
Console.WriteLine("byte array: " + BitConverter.ToString(bytes)); 


// Output: byte array: 9A-50-07-0C 


i]. n———————3J: 0$ 
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BitConverter 


IsLittleEndian 
类 型 (CH 编程 指南 ) 


如 何 : 将 字符 串 转 换 为 数字 (CHE 编程 指南 ) 


可 以 使 用 Convert 类 中 的 方法 或 使 用 各 种 数值 类 型 (int、long、float 等 ) 中 的 
TryParse 方法 将 字符 串 转 换 为 数字 。 


如 果 你 具有 字符 串 ， 则 调用 TryParse 方法 (例如 int. TryParse(^11")) 会 稍微 更 加 
高 效 且 简单 。 使 用 Convert 方法 对 于 实现 IConvertible 的 常规 对 象 更 有 用 。 


可 以 对 预期 字符 串 会 包含 的 数值 类 型 (如 System.Int32 类 型 ) 使 用 Parse 或 
TryParse 方法 。 Convert.ToUlnt32 方法 在 内 部 使 用 Parse。 如 果 字 符 串 的 格式 无 
效 ， 则 Parse 会 引发 异常 ， 而 TryParse 会 返回 false。 


Parse 和 TryParse 方法 会 忽略 字符 串 开 头 和 末尾 的 空格 ， 但 所 有 其 他 字符 必须 是 
组 成 合适 数值 类 型 (int、long、ulong、float、decimal 等 ) 的 字符 。 组 成 数字 的 字 
符 中 的 任何 空格 都 会 导致 错误 。 例 如 ， 可 以 使 用 decimal.TryParse 分 

析 “10”“10.3”"“ 10 ”， 但 不 能 使 用 此 方法 分 析 从 “10X”“1 0” (注意 空格 ) '10 
.3” (注意 空格 ) . "10e1" (float.TryParse 在 此 处 适用 ) 等 中 分 析出 10。 


下 面 的 示例 演示 了 对 Parse 和 TryParse 的 成 功 调用 和 不 成 功 的 调用 。 


using System; 

using System.Ling; 

using System.Collections; 

using System.Collections.Generic; 


int numVal - Int32.Parse("-105"); 
Console.WriteLine(numVal); 
// Output: -105 


// TryParse returns true if the conversion succeeded 
// and stores the result in j. 
ane Je 
if (Int32.TryParse("-105", out j)) 
Console.WriteLine(j); 
else 
Console.WriteLine("String could not be parsed."); 
// Output: -105 


try 
{ 


int m = Int32.Parse("abc"); 
catch (FormatException e) 
{ 


Console.WriteLine(e.Message); 


// Output: Input string was not in a correct format. 


string inputString - "abc"; 
int numValue; 
bool parsed - Int32.TryParse(inputString, out numValue); 


if (!parsed) 
Console.WriteLine("Int32.TryParse could not parse '{0}' to an: 


// Output: Int32.TryParse could not parse 'abc' to an int. 


加 一 —g 





// This snippet shows a couple of examples that extract number cha! 

// beginning of the string to avoid TryParse errors. 

StringBuilder sb - new StringBuilder(); 

var str = " 10FFxxx"; 

foreach (char c in str) ( 
// Check for numeric characters (hex in this case). Add "." ar 
// and remove letters. Include initial space because it is hai 
if ((c >= 'O' && c <= '9') || (c >= 'A' && c <= 'F') || (c >= 

sb.Append(c); 


else 
break; 


if (int.TryParse(sb.ToString(), System.Globalization.NumberStyles.| 
Console.WriteLine(sb.ToString()); 


str =" -10FFXXX"; 

sb.Clear(); 

foreach (char c in str) { 
// Check for numeric characters (allow negative in this case bt 
// Though we use int.TryParse in the previous example and this 
// allow a sign character (-) AND hex digits at the same time. 
// Include initial space because it is harmless. 


if ((c >= 'O' && c <= '9') || c == ' ' || c == '-') { 
sb.Append(c); 

} else 
break; 


if (int.TryParse(sb.ToString(), out i)) 
Console.WriteLine(sb.ToString()); 


E 0 0 000 0 B 
下 表 列 出 了 Convert 类 中 可 使 用 的 一 些 方法 。 





数值 类 型 方法 

decimal ToDecimal(String) 

float ToSingle(String) 

double ToDouble(String) 

short Tolnt16(String) 

int Tolnt32(String) 

long Tolnt64(String) 

ushort ToUInt16(String) 

uint ToUInt32(String) 


ulong ToUInt64 (String) 


此 示例 调用 Convert.ToInt32(String) 方法 将 输入 的 string RA int. fg HRS IR LEG 
方法 可 能 引发 的 最 常见 的 两 个 异常 : FormatException 和 OverflowException, 40 
果 该 数字 可 以 递增 而 不 浴 出 整数 存储 位 置 ， 则 程序 使 结果 加 上 1 并 打印 输出 。 


using System; 

using System.Ling; 

using System.Collections; 

using System.Collections.Generic; 


static void Main(string[] args) 


i 


int numVal = -1; 
bool repeat = true; 


while (repeat) 


{ 


Console.WriteLine("Enter a number between -2, 147,483,648 ar 
string input = Console.ReadLine(); 


// ToInt32 can throw FormatException or OverflowException. 
try 


{ 
numVal = Convert.ToInt32(input); 
j 
catch (FormatException e) 
{ 
Console.WriteLine("Input string is not a sequence of d: 
j 
catch (OverflowException e) 
{ 
Console.WriteLine("The number cannot fit in an Int32."" 
} 
finally 
{ 
if (numVal < Int32.MaxValue) 
{ 
Console.WriteLine("The new value is {0}", numVal + 
j 
else 
{ 
Console.WriteLine("numVal cannot be incremented be 
j 
j 


Console.WriteLine("Go again? Y/N"); 
string go = Console.ReadLine(); 

TAR (go 二 二 WA | | go 二 二 "y") 

{ 


} 


repeat = true; 


else 


{ 
} 


repeat = false; 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


// Sample Output: 

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclu: 
// 473 

// The new value is 474 

// Go again? Y/N 

// y 

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclu: 
// 2147483647 

// numVal cannot be incremented beyond its current value 

// Go again? Y/N 

VUL. 

// Enter a number between -2,147,483,648 and +2,147,483,647 (inclu: 
// -1000 

// The new value is -999 

// Go again? Y/N 

// n 

// Press any key to exit. 


Ee 





请 参阅 


类 型 (CH 编程 指南 ) 
如 何 : 确定 字符 串 是 否 表示 数值 (CH 编程 指南 ) 
.NET Framework 4 格式 设置 实用 工具 


如 何 : 在 十 六 进 制 字符 串 与 数值 类 型 之 间 转 换 (CH 
编程 指责) 
以 下 示例 演示 如 何 执行 下 列 任务 : 

e. 获取 字符 串 中 每 个 字符 的 十 六 进 制 值 。 

e. 获取 与 十 六 进 制 字符 串 中 的 每 个 值 对 应 的 字符 。 

e. 将 十 六 进 制 string 转换 为 整 型 。 

e 将 十 六 进 制 string 转换 为 浮 点 型 。 

e 将 字 节 数组 转换 为 十 六 进 制 string. 


此 示例 输出 string 中 的 每 个 字符 的 十 六 进 制 值 。 首 先 ， 它 将 string 分 析 为 字符 数 
组 ， 然 后 对 每 个 字符 调用 Tolnt32(Char) 以 获取 相应 的 数字 值 。 最 后 ， 在 string 中 
将 数字 的 格式 设置 为 十 六 进 制 表示 形式 。 


string input = "Hello World!"; 
char[] values = input.ToCharArray(); 
foreach (char letter in values) 


1 
// Get the integral value of the character. 
int value = Convert.ToInt32(letter); 
// Convert the decimal value to a hexadecimal value in string ! 
string hexOutput = String.Format("{0:X}", value); 
Console.WriteLine("Hexadecimal value of (0) is {1}", letter, he 
} 
/* Output: 
Hexadecimal value of H is 48 
Hexadecimal value of e is 65 
Hexadecimal value of 1 is 6C 
Hexadecimal value of 1 is 6C 
Hexadecimal value of o is 6F 
Hexadecimal value of is 20 
Hexadecimal value of W is 57 
Hexadecimal value of o is 6F 
Hexadecimal value of r is 72 
Hexadecimal value of 1 is 6C 
Hexadecimal value of d is 64 
Hexadecimal value of ! is 21 
wh 





此 示例 分 析 十 六 进 制 值 的 string 并 输出 对 应 于 每 个 十 六 进 制 值 的 字符 。 首 先 ， 它 调 
FA Split(Char[]) 方法 以 获取 每 个 十 六 进 制 值 作 为 数组 中 的 单个 string。 然 后 调用 
ToInt32(String, Int32) 以 将 十 六 进 制 转换 为 表示 为 int 的 十 进 制 值 。 示 例 中 演示 了 


用 于 获取 对 应 于 该 字符 代码 的 字符 的 两 种 不 同方 法 。 第 一 种 方法 是 使 用 
ConvertFromUtf32(Int32)， 它 将 对 应 于 整 型 参数 的 字符 作为 string 返回 。 第 二 种 
方法 是 将 int 显 式 转换 为 char。 


string hexValues = "48 65 6C 6C 6F 20 57 6F 72 6C 64 21"; 
string[] hexValuesSplit - hexValues.Split(' '); 
foreach (String hex in hexValuesSplit) 


{ 
// Convert the number expressed in base-16 to an integer. 
int value = Convert.ToInt32(hex, 16); 
// Get the character corresponding to the integral value. 
string stringValue = Char.ConvertFromUtf32(value); 
char charValue = (char)value; 
Console.WriteLine("hexadecimal value = (0), int value = {1}, cl 

hex, value, stringValue, charValue); 

} 

/* Output: 
hexadecimal value = 48, int value = 72, char value - H or H 
hexadecimal value = 65, int value = 101, char value = eor e 
hexadecimal value = 6C, int value = 108, char value = lor 1 
hexadecimal value = 6C, int value = 108, char value = lor 1 
hexadecimal value = 6F, int value = 111, char value = o or o 
hexadecimal value = 20, int value = 32, char value = or 
hexadecimal value = 57, int value = 87, char value = W or W 
hexadecimal value = 6F, int value = 111, char value = o or o 
hexadecimal value = 72, int value = 114, char value = r or r 
hexadecimal value = 6C, int value = 108, char value = lor 1 
hexadecimal value = 64, int value = 100, char value = d or d 
hexadecimal value = 21, int value = 33, char value = ! or ! 

27 





此 示例 演示 了 将 十 六 进 制 string 转换 为 整数 的 另 一 种 方法 ， 即 调用 Parse(String, 
NumberStyles) 方法 。 


string hexString = "8E2"; 

int num - Int32.Parse(hexString, System.Globalization.NumberStyles 
Console.WriteLine(num); 

//Output: 2274 


[i] pen | 


下 面 的 示例 演示 如 何 使 用 System.BitConverter 类 和 Int32.Parse 方法 将 十 六 进 制 
string 转换 为 浮 点 型 。 





string hexString - "43480170"; 
uint num = uint.Parse(hexString, System.Globalization.NumberStyles 


byte[] floatVals - BitConverter.GetBytes(num); 
float f - BitConverter.ToSingle(floatVals, 0); 
Console.WriteLine("float convert = {0}", f); 


// Output: 200.0056 








下 面 的 示例 演示 如 何 使 用 System.BitConverter 类 将 字 节 数组 转换 为 十 六 进 制 字符 
FR. 


byte[] vals = ( 0x01, OxAA, OxB1, OxDC, Ox10, OxDD }; 


string str - BitConverter.ToString(vals); 
Console.WriteLine(str); 


str - BitConverter.ToString(vals).Replace("-", ""); 
Console.WriteLine(str); 


/*Output: 
01-AA-B1-DC-10-DD 


O1AAB1DC1O0DD 
ns 
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类 型 (CH 编程 指南 ) 
如 何 : 确定 字符 串 是 否 表 示 数 值 (CH 编程 指南 ) 


不 安全 代码 和 指针 (CH 编程 指南 ) 


为 了 保持 类 型 安全 ， 默 认 情 况 下 ，C# 不 支持 指针 算法 。 不 过 ， 通 过 使 用 unsafe X 
键 字 ， 可 以 定义 可 使 用 指针 的 不 安全 上 下 文 。 有 关 指 针 的 更 多 信息 ， 请 参见 主题 指 
针 类 型 。 

8 注意 

在 公共 语言 运行 时 (CLR) 中 ， 不 安全 代码 是 指 无 法 验证 的 代码 。C# 中 的 不 安全 
代码 不 一 定 是 危险 的 ; 只 是 其 安全 性 无 法 由 CLR 进行 验证 的 代码 。 因 此 ，CLR 
只 对 在 完全 受信 任 的 程序 集中 的 不 安全 代码 执行 操作 。 如 果 使 用 不 安全 代码 ， 
由 您 负责 确保 您 的 代码 不 会 引起 安全 风险 或 指针 错误 。 


不 安全 代码 概述 
不 安全 代码 具有 下 列 属性 : 
。 方 法、 类 型 和 可 被 定义 为 不 安全 的 代码 块 。 
e 在 某 些 情况 下 ， 通 过 移 除数 组 界限 检查 ， 不 安全 代码 可 提高 应 用 程序 的 性 能 。 
e 当 调 用 需要 指针 的 本 机 函数 时 ， 需 要 使 用 不 安全 代码 。 
。 使 用 不 安全 代码 将 引起 安全 风险 和 稳定 性 风险 。 
e 在 CH 中， 为 了 编译 不 安全 代码 ， 必 须 用 /unsafe 编译 应 用 程序 。 


相关 章节 


有 关 更 多 信息 ， 请 参见 : 
e 指针 类 型 (C# 编程 指南 ) 
e 固定 大 小 的 缓冲 区 (CH 编程 指南 ) 
e 如何 : 使 用 指针 复制 字 节 数组 (CH 编程 指南 ) 
e unsafe (C# 参考 ) 


a 


CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 
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不 安全 代码 和 指针 (CH 编程 指南 ) 560 


固定 大 小 的 缓冲 区 (CH 编程 指南 ) 


在 C# 中 ， 可 以 使 用 fixed 语句 在 数据 结构 中 创建 带 有 固定 大 小 数组 的 缓冲 区 。 使 
用 现 有 代码 〈 如 使 用 其 他 语言 、 预 先 存 在 的 DLL 或 COM 项 目 编写 的 代码 ) 时 ， 这 
种 方法 非常 有 用 。 固 定数 组 可 采用 人 允许 普通 结构 成 员 使 用 的 任何 特性 或 修饰 符 。 唯 
一 的 限制 是 ， 数 组 类 型 必须 是 bool、byte、 char、 

short, int, long, sbyte, ushort, uint, ulong, float 或 double, 


private fixed char name[30]; 


备注 


在 早期 版 本 的 C# 中 ， 声 明 C++ 样式 的 固定 大 小 结构 是 很 困难 的 ， 因 为 包含 数组 的 
CH 结构 不 包含 数组 元 素 。 相 反 ， 该 结构 包含 对 元 素 的 引用 。 


C# 2.0 添加 了 在 struct ( 当 用 在 unsafe 代码 块 中 时 ) 中 人 散人 入 固定 大 小 的 数组 的 功 


Ak 
Abo 


例如 ， 在 C# 2.0 之 前 ， 下 面 的 struct 的 大 小 为 8 字 节 。 pathName 数组 是 对 堆 分 
配 数组 的 引用 : 


public struct MyArray 


{ 
public char[] pathName; 
private int reserved; 


M C£ 2.0 FiA, struct TUASRAW A. ERE ARIA, fixedBuffer 数组 
有 固定 的 大 小 。 若 要 访问 数组 的 元 素 ， 应 使 用 fixed 语句 建立 指向 第 一 个 元 素 的 指 
s+. fixed 语句 将 fixedBuffer 实例 固定 到 内 存 中 的 特定 位 置 。 


namespace FixedSizeBuffers 


{ 
internal unsafe struct MyBuffer 
public fixed char fixedBuffer[128]; 
j 
internal unsafe class MyClass 
public MyBuffer myBuffer - default(MyBuffer); 
} 
internal class Program 
{ 
static void Main() 
MyClass myC - new MyClass(); 
unsafe 
// Pin the buffer to a fixed location in memory. 
fixed (char* charPtr - myC.myBuffer.fixedBuffer) 
*charPtr = 'A'; 
} 
} 
} 
} 
} 


128 个 元 素 的 char 数组 的 大 小 为 256 字 节 。 在 固定 大 小 的 char 缓冲 区 中 ， 每 个 字 
符 始 终 占 用 两 个 字 节 ， 而 与 编码 无 关 。 即 使 季 char 缓冲 区 封 送 到 具有 CharSet = 
CharSet.Auto 或 CharSet = CharSet.Ansi 的 API 方法 或 结构 ， 也 是 如 此 。 有 关 更 
多 信息 ， 请 参见 CharSet。 


另 一 种 常见 的 固定 大 小 的 数组 是 bool 数组 。 bool 数组 中 元 素 的 大 小 始终 为 一 个 字 
节 。 bool 数组 不 适合 于 创建 位 数组 或 缓冲 区 。 


o MP 
Ef TER 


除了 用 stackalloc 创建 的 内 存 之 外 ，C# 编译 器 和 公共 语言 运行 时 (CLR) 不 执行 
任何 安全 缓冲 区 浴 出 检查 。 与 所 有 不 安全 代码 一 样 ， 请 谨慎 使 用 。 


不 安全 缓冲 区 和 与 常规 数组 在 以 下 方面 不 同 : 
e 不 安全 缓冲 区 只 能 用 在 不 安全 上 下 文中 。 
e 不 安全 缓冲 区 始终 是 向 量 (或 一 维 数 组 ) 。 
e 数组 的 声明 应 包括 计数 ， 如 char id[8]。 而 不 能 使 用 char id[。 
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。 不 安全 缓冲 区 只 能 是 不 安全 上 下 文中 的 结构 的 实例 字段 。 


CH 编程 指南 

不 安全 代码 和 指针 (CH 编程 指南 ) 
fixed 语句 (CH 参考 ) 

互 操作 性 (CH 编程 指南 ) 


固定 大 小 的 缓冲 区 (CH 编程 指南 ) 


指针 类 型 (CH 编程 指责) 


在 不 安全 的 上 下 文中 ， 类 型 可 以 是 指针 类 型 、 值 类 型 或 引用 类 型 。 指 针 类 型 声明 采 
用 下 列 形 式 之 一 : 


type* identifier; 
void* identifier; //allowed but not recommended 


以 下 任 一 类 型 均 可 为 指针 类 型 : 


e Sbyte, byte, short, ushort, int, uint, long. ulong, char, float, double, 
decimal sX bool, 


o 任何 枚 举 类 型 。 
。 任何 指针 类 型 。 
e 任何 仅 包含 非 托 管 类 型 字段 的 用 户 定义 的 结构 类 型 。 


指针 类 型 不 从 object 继承 ， 并 且 指 针 类 型 与 object 之 间 不 存在 转换 。 此 外 ， 装 箱 

和 取消 装 箱 不 支持 指针 。 但 是 ， 你 可 在 不 同 的 指针 类 型 之 间 以 及 指针 类 型 和 整 型 之 
间 进 行 转 换 。 

在 同一 个 声明 中 声明 多 个 指针 时 ， 星 号 (*) 仅 和 与 基础 类 型 一 起 写 入 ; 而 不 是 用 作 每 

个 指针 名 称 的 前 级 。 例 如 : 


ine pi p2 P3; // Ok 
ime *ple p2 “ps; // Invalid in C# 


指针 不 能 指向 引用 或 包含 引用 的 struct， 因 为 无 法 对 对 象 引用 进行 垃圾 回收 ， 即 使 
有 指针 指向 它 也 是 如 此 。 垃 圾 回收 器 并 不 跟踪 是 否 有 任何 类 型 的 指针 指向 对 象 。 


myType* 类 型 的 指针 变量 的 值 为 myType 类 型 的 变量 的 地 址 。 下 面 是 指针 类 型 声明 
的 示例 : 


示例 说 明 
int* p p 是 指向 整数 的 指针 。 
into p 是 指向 整数 的 指针 的 指针 。 
int*[] p p 是 指向 整数 的 指针 的 一 维 数组 。 
char* p p 是 指向 字符 的 指针 。 


void* p p 是 指向 未 知 类 型 的 指针 。 


指针 间接 寻 址 运算 符 * 可 用 于 访问 位 于 指针 变量 所 指向 的 位 置 的 内 容 。 例 如 ， 请 考 
虑 以 下 声明 : 


int* myVariable; 


表达 式 myVariable 表示 在 myVariable 中 包含 的 地 址 处 找到 的 *int 变量 。 


主题 fixed 语句 (CH 参考 ) 和 指针 转换 (CH 编程 指南 ) 包含 了 多 个 指针 示例 。 下 
面 的 示例 显示 需要 unsafe 关键 字 和 fixed 语句 以 及 如 何 递增 内 部 指针 。 你 可 将 此 
代码 粘贴 到 控制 台 应 用 程序 的 Main 函数 中 来 运行 它 。 ( 记 住 在 “项 目 设计 器 ”中 局 
用 不 安全 代码 ; 选择 菜单 栏 上 的 项目” “属性 ”， 然 后 选择 “生成 ”选项 卡 中 的 “人 允 
许 不 安全 代码 ”。) 


// Normal pointer to an object. 

int[] a = new int[5] (10, 20, 30, 40, 50}; 

// Must be in unsafe code to use interior pointers. 
unsafe 


// Must pin object on heap so that it doesn't move while using 
fixed (int* p - &a[0]) 
{ 
// p is pinned as well as object, so create another pointe! 
Int p2 = p; 
Console.WriteLine(*p2); 
// Incrementing p2 bumps the pointer by four bytes due to : 
p2 += 1; 
Console.WriteLine(*p2); 
p2 += 1; 
Console.WriteLine(*p2); 
Console.WriteLine("-------- n 
Console.WriteLine(*p); 
// Deferencing p and incrementing changes the value of a[0. 
SIE sex dim 
Console.WriteLine(*p); 
SO a= ly 
Console.WriteLine(*p); 


j 


Console.WriteLine("-------- 5) 
Console.WriteLine(a[0]); 
Console.ReadLine(); 


// Output: 





你 无 法 对 void* 关 型 的 指针 应 用 间接 寻 址 运算 符 。 但 是 ， 你 可 以 使 用 强制 转换 将 
void 指针 转换 为 任何 其 他 指针 类 型 ， 反 之 亦 然 。 
指针 可 以 为 null。 将 间接 寻 址 运算 符 占 用 于 null 指针 将 导致 由 实现 定义 的 行为 。 


请 注意 ， 在 方法 之 间 传 递 指针 会 导致 未 定义 的 行为 。 示 例 通过 Out 或 Ref 参数 或 作 
为 函数 结果 返回 一 个 指向 局 部 变量 的 指针 。 如 果 已 在 固定 块 中 设置 指针 ， 则 它 指向 
的 变量 不 再 是 固定 的 。 


下 表 列 出 了 可 在 不 安全 的 上 下 文中 对 指针 执行 的 运算 符 和 语句 : 


运算 符 / 语 句 
-> 
[] 
& 
++ 和 - 
+ 和 - 
==, Iz <, >. <= 和 >= 
stackalloc 
fixed 语句 
CH 语言 规范 


有 关 详 细 信 息 ^, ime 阅 C# i Ta 2 = we 


请 参阅 
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不 安全 代码 和 指针 (CH 编程 指南 ) 
指针 转换 (C# 编程 指南 ) 

指针 表达 式 (CH 编程 指南 ) 

类 型 (Ci SS) 

unsafe (C# €) 

fixed 语句 (CH 参考 ) 

stackalloc (C£ 参考 ) 

装 箱 和 取消 装 箱 (CH 编程 指南 ) 


用 法 

执行 指针 间接 寻 址 。 
通过 指针 访问 结构 的 成 员 。 
为 指针 建立 索引 。 
获取 变量 的 地 址 。 

递增 和 递减 指针 。 
执行 指针 算法 。 
比较 指针 。 
在 堆栈 上 分 配 内 存 。 
临时 固定 变量 以 便 找到 其 地 址 。 


Bie CH 语法 和 用 法 的 权威 资料 。 


XML 文档 注释 (CH 编程 指南 ) 


在 Visual C# 中 ， 你 可 以 通过 以 下 方式 为 代码 创建 文档 : 将 特殊 注释 字段 中 的 XML 
元 素 包 含 在 源 代码 中 注释 引用 的 代码 块 的 前 面 ， 例 如 : 


/// <summary> 

/// This class performs an important function. 
/// «/summary» 

public class MyClass{} 


使 用 /doc 选项 进行 编译 时 ， 编 译 器 将 在 源 代 码 中 搜索 所 有 XML 标记 ， 并 创建 一 个 
XML 文档 文件 。 若 要 基于 编译 器 生成 的 文件 创建 最 终 文档 ， 你 可 以 创建 一 个 自 定义 
工具 ， 也 可 以 使 用 Sandcastle 等 工具 。 


若 要 引用 XML 元 素 (例如 ， 你 的 函数 将 处 理 你 要 在 XML 文档 注释 中 描述 的 特定 
XML TR) ， 你 可 使 用 标准 引用 机 制 (< 和 >) 。 若 要 引用 代码 引用 (cref) 元 素 中 
的 通用 标识 符 ， 则 可 使 用 转 义 字符 (例如 ，cref=”List<T>”) 或 大 括号 
(cref=”List{T}》”)。 作 为 特例 ， 编 译 器 会 业 大 括号 解析 为 尖 括 号 以 在 引用 通用 标识 符 
时 使 作者 能 够 更 轻松 地 进行 文档 注释 。 
8 注意 
XML 文档 注释 不 是 元 数据 ; 它们 不 包括 在 编译 的 程序 集中 ， 因 此 无 法 通过 反射 
对 其 进行 访问 。 
本 节 内 容 
e 建议 的 文档 注释 标记 
e 处 理 XML 文件 
文档 标记 分 隔 符 
e 如 何 : 使 用 XML 文档 功能 


相关 章节 


有 关 详 细 信 息 ， 请 参阅 : 


e /doc (处 理 文档 注释 ) 


有 关 详 细 信 息 ， 请 参阅 C# EG. ÓjuseBAGRiÉCHIIGNFBIEB A 


请 参阅 


C 编程 指南 


建议 的 文档 注释 标记 (CH 编程 指南 ) 

CH 编译 器 处 理 代 码 中 的 文档 注释 ， 闻 它们 设置 为 XML 文件 格式 ， 其 文件 名 在 
/doc 命令 行 选项 中 指定 。 若 要 创建 基于 编译 器 生成 的 文件 的 最 终 文 档 ， 您 可 以 创建 
自 定义 工具 ， 也 可 以 使 用 诸如 等 工具 约定 。 

在 代码 构造 (如 类 型 和 类 型 成 员 ) 上 义理 标记 。 

8 注意 


文档 注释 不 能 应 用 于 命名 空间 。 
编译 器 将 义理 任何 为 有 效 XML 的 标记 。 下 列 标记 提供 了 用 户 文档 中 常用 的 功能 。 


标记 
<c> <para> <see>* 
<code> <param>* <seealso>* 
<example> <paramref> <summary> 
<exception>* <permission>* <typeparam>* 
<include>* <remarks> <typeparamref> 
<list> <returns> <value> 


(* 表示 编译 器 验证 语法 。) 
如 果 想 要 尖 括 号 出 现在 文档 注释 文本 中 ， 使 用 < 和 >。 如 下 面 示 例 所 示 。 
XML 


/// «summary cref="C &lt; T &gt;"> 
/// </summary> 


请 参阅 


CH 编程 指南 
/doc (C£ Compiler Options) 
XML 文档 注释 (CH 编程 指南 ) 


义理 XML 文件 (CH 编程 指 丙 ) 


编译 器 为 代码 中 被 标记 为 生成 文档 的 每 一 个 构造 生成 一 个 ID 字符 串 。 (有 关 如 何 
标记 代码 的 信息 ， 请 参见 建议 的 文档 注释 标记 。) ID 字符 串 唯一 地 标识 构造 。 处 理 
XML 文件 的 程序 可 以 使 用 ID 字符 串 标识 文档 应 用 于 的 相应 .NET Framework 元 数 
据 / 反 射 项 。 


XML 文件 不 是 代码 的 分 层 表示 形式 ， 它 是 一 个 平面 列表 ， 其 中 的 每 一 个 元 素 都 有 一 
个 生成 的 ID. 


编译 器 在 生成 ID 字符 串 时 遵循 下 列 规则 : 
e 字符 串 中 没有 空白 。 


e ID 字符 串 的 第 一 部 分 通过 单个 字符 后 跟 一 个 冒号 来 标识 所 标识 成 员 的 种 类 。 使 
用 下 列 成 员 类 型 : 


M 说 明 
N 命名 空 间 不 可 将 文档 注释 添加 | 命名 空 间 中 ， 但 是 可 以 对 它们 进行 cref 5| 


用 在 受 支 持 的 位 置 ) 。 

T 类 型 : 类 、 接 口 、 结 构 、 枚 举 、 委 托 

F FR 

P 属性 (包括 索引 程序 或 其 他 索引 属性 ) 

M ”方法 (包括 一 些 特殊 方法 ， 例 如 构造 画 数 、 运 算 符 等 ) 

E event 

错误 字符 串 字 符 串 的 其 余部 分 会 提供 有 关 此 错误 的 信息 。C# 编译 器 为 无 
法 解析 的 链接 生成 错误 信息 。 


e 字符 串 的 第 二 部 分 是 项 的 完全 限定 名 ， 从 命名 空间 的 根 开始 。 项 的 名 称 、 其 在 
闭 类 型 和 命名 空间 以 句号 分 隔 。 如 果 项 的 名 称 本 身 包含 句号 ， 则 用 哈 希 符号 
(P) 替换 这 些 句号 。 假 定 任何 项 的 名 称 中 都 不 直接 存在 哈 希 符号 。 例 如 ， 
String 构造 函数 的 完全 限定 名 是 “System.String.#ctor"。 


对 于 属性 和 方法 ， 如 果 该 方法 带 参 数 ， 则 将 其 后 的 参数 列表 括 在 括号 中 。 如 果 
没有 参数 ， 则 没有 括号 。 多 个 参数 以 各 号 分 隔 。 每 个 参数 的 编码 都 直接 遵循 它 
ft .NET Framework 签名 中 的 编码 方法 : 


o 基 类 型 。 常 规 类 型 (ELEMENT TYPE CLASS 或 
ELEMENT_TYPE_VALUETYPE) 表示 为 类 型 的 完全 限定 名 。 


o ABBA ($0, ELEMENT TYPE l4, ELEMENT TYPE OBJECT. 
ELEMENT TYPE STRING, ELEMENT TYPE TYPEDBYREF, $I 
ELEMENT TYPE VOID) 表示 为 相应 完全 类 型 的 完全 限定 名 。 例 如 ， 
System.lnt32 或 System.TypedReference。 


o ELEMENT TYPE PTR 表示 为 “"”， 在 修改 的 类 型 之 后 。 
o ELEMENT TYPE BYREF 表示 为 “@”， 在 修改 的 类 型 之 后 。 


o ELEMENT TYPE PINNED 表示 为 “， 在 修改 的 类 型 之 后 。C# 编译 器 永 
远 不 会 生成 此 结果 。 


o ELEMENT TYPE CMOD REQ 表示 为 和 修饰 符 类 的 完全 限定 名 ， 在 
修改 的 类 型 之 后 。C# 编译 器 永远 不 会 生成 此 结果 。 


o ELEMENT TYPE CMOD OPT 表示 为 ““ 和 修饰 符 类 的 完全 限定 名 ， 在 修 
改 的 类 型 之 后 。 


o ELEMENT TYPE SZARRAY 表示 为 “[]， 在 数组 的 元 素 类 型 之 后 。 


o ELEMENT TYPE GENERICARRAY 表示 为 人?]”， 在 数组 的 元 素 类 型 之 
Ip. CH 编译 器 永远 不 会 生成 此 结果 。 

o ELEMENTTYPE ARRAY 表示 为 [ lowerbound:size,lowerbound:size], 
其 中 去 号 数 为 秩 - 1， 每 一 维 的 下 限 和 大 小 (REA) 用 十 进 制 表示 。 
如 果 未 指定 下 限 及 大 小 ， 它 将 完全 被 省 略 。 如 果 省 略 了 特定 维 的 下 限 及 大 
NN, WO TURES, PISO, Lh 1 作为 下 限 并 且 未 指定 大 小 的 二 维 数组 是 
[As 

o ELEMENTTYPE FNPTR RT A “=FUNC:_type(signature)’, P type 
是 返回 类 型 ，signature 是 方法 的 参数 。 如 果 没 有 参数 ， 则 将 省 略 括号 。 
C# 编译 器 永远 不 会 生成 此 结果 。 


不 表示 下 列 签名 组 件 ， 因 为 从 不 使 用 它们 来 区 分 重 载 方法 : 
o 调用 约定 
o 返回 类 型 
o ELEMENT TYPE SENTINEL 


仅 对 于 转换 运算 符 (op Implicit 和 op Explicit) ， 方 法 的 返回 值 才 被 编码 
为 “~”， 后 跟 返 回 类 型 ， 如 上 述 编码 所 示 。 

对 于 泛 型 类 型 ， 类 型 名 称 后 跟 反 勾 号 ， 再 跟 一 个 数字 ， 指 示 泛 型 类 型 参数 的 个 
数 。 例 如 ， 

对 于 定义 为 public class SampleClass«T, U» 的 类 型 ，<member 
name-"T:SampleClass 2"> 是 其 标记 。 

对 于 接受 泛 型 类 型 作为 参数 的 方法 ， 泛 型 类 型 参数 被 指定 为 数字 前 面 加 上 反 勾 
号 (如 o. 1) 。 表 示 类 型 泛 型 参数 的 数组 表示 法 (MSF) 的 每 个 数字 。 


示例 
下 列 示例 显示 了 如 何 生成 类 及 其 成 员 的 ID 字符 串 : 


namespace N 
{ 
/// <summary> 
/// Enter description here for class X. 
/// ID string generated is "T:N.X". 
/// </summary> 
public unsafe class X 
{ 
/// «summary» 
/// Enter description here for the first constructor. 
/// ID string generated is "M:N.X.#ctor". 
/// </summary> 
public X() { } 


/// «summary» 

/// Enter description here for the second constructor. 
/// ID string generated is "M:N.X.#ctor(System.Int32)". 
/// </summary> 

/// «param name="i">Describe parameter .</param> 

public X(int i) { } 


/// <summary> 

/// Enter description here for field q. 
/// ID string generated is "F:N.X.q". 
/// </summary> 

public string q; 


/// <summary> 

/// Enter description for constant PI. 
/// ID string generated is "F:N.X.PI". 
/// </summary> 

public const double PI = 3.14; 


/// <summary> 

/// Enter description for method f. 

/// ID string generated is "M:N.X.f". 

/// </summary> 

/// <returns>Describe return value.</returns> 
public int f() { return 1; } 


/// <summary> 

/// Enter description for method bb. 

/// ID string generated is "M:N.X.bb(System.String, System.: 
/// </summary> 

/// <param name="s">Describe parameter .</param> 

/// <param name="y">Describe parameter .</param> 

/// <param namez"z"»Describe parameter .</param> 


/// «returns»Describe return value.</returns> 
public int bb(string s, ref int y, void* z) ( return 1; } 


/// «summary» 

/// Enter description for method gg. 

/// ID string generated is "M:N.X.gg(System.Inti16[],System 
/// </summary> 

/// «param name="arrayi">Describe parameter .</param> 

/// <param name="array">Describe parameter .</param> 

/// <returns>Describe return value.</returns> 

public int gg(short[] array1, int[,] array) { return 0; } 


/// <summary> 

/// Enter description for operator. 

/// ID string generated is "M:N.X.op Addition(N.X,N.X)". 
/// </summary> 

/// «param name="x">Describe parameter .</param> 

/// «param name="xx">Describe parameter .</param> 

/// <returns>Describe return value.</returns> 

public static X operator +(X x, X xx) { return x; } 


/// «summary» 

/// Enter description for property. 

/// ID string generated is "P:N.X.prop". 

/// </summary> 

public int prop { get { return 1; } set ( } } 


/// <summary> 

/// Enter description for event. 

/// ID string generated is "E:N.X.d". 
/// </summary> 

public event D d; 


/// «summary» 

/// Enter description for property. 

/// ID string generated is "P:N.X.Item(System.String)". 
/// </summary> 

/// «param name="s">Describe parameter .</param> 

/// <returns></returns> 

public int this[string s] { get { return 1; } } 


/// <summary> 

/// Enter description for class Nested. 
/// ID string generated is "T:N.X.Nested". 
/// </summary> 

public class Nested { } 


/// «summary» 

/// Enter description for delegate. 

/// ID string generated is "T:N.X.D". 

/// </summary> 

/// <param name="i">Describe parameter .</param> 
public delegate void D(int i); 


/// «summary» 

/// Enter description for operator. 

/// ID string generated is "M:N.X.op Explicit(N.X)-System.: 
/// «/summary» 

/// «param name="x">Describe parameter .</param> 

/// <returns>Describe return value.</returns> 

public static explicit operator int(X x) ( return 1; } 


j 





gl 
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文档 标记 的 分 隔 符 (CH 编程 指南 ) 

使 用 XML doc 注释 需要 分 隔 符 ， 分 隔 符 为 编译 器 指示 文档 注释 的 起 止 位 置 。XML 
文档 标记 可 以 与 以 下 几 种 分 隔 符 一 起 使 用 : 

Ill 


单行 分 隔 符 。 这 是 显示 在 文档 示例 中 并 由 Visual C£ 项 目 模板 使 用 的 形式 。 如 果 有 
后 接 分 隔 符 的 空白 字符 ， 则 此 字符 将 不 包括 在 XML 输出 中 。 


u 注意 
Visual Studio IDE 具有 一 项 称 为 “智能 注释 编辑 ”的 功能 ， 它 自动 插入 

<summary> 和 </summary> 标记 ， 并 且 当 您 在 代码 编辑 器 中 键入 /// 分 隔 符 后 

将 光标 移动 到 这 些 标 记 内 。 从 项 目 属性 页 的 选项 、 文 本 编辑 器 、C#、 格 式 设置 

可 以 访问 此 功能 。 

/*/ 
多 行 分 隔 符 。 
以 下 是 使 用 /*/ 分 隔 符 时 要 遵循 的 一 些 格式 设置 规则 : 

e 对 于 包含 / 分 隔 符 的 行 ， 如 果 该 行 的 其 余部 分 为 空白 ， 则 不 将 该 行 处 理 为 注 
释 。 如 果 / 分 隔 符 后 面 的 第 一 个 字符 为 空白 ， 则 忽略 此 空白 字符 并 处理 该 行 的 
剩余 部 分 。 否 则 ， 将 /* 分 隔 符 后 的 整 行 文本 处 理 为 注释 的 一 部 分 。 

对 于 包含 /分隔 符 的 行 ， 如 果 到 / 分 隔 符 为 止 仅 有 空白 ， 则 忽略 该 行 。 否 则 ， 
将 到 */ 分 隔 符 为 止 的 那 行文 本 处 理 为 注释 的 一 部 分 ， 同 时 必须 遵循 以 下 描述 的 
模式 匹配 规则 。 

对 于 以 / 分 隔 符 开头 的 行 后 面 的 那些 行 ， 编 译 器 会 在 每 个 行 的 开头 寻找 一 个 常 
用 模式 。 该 模式 可 以 包含 可 选 的 空白 和 一 个 星 号 (*)， 后 跟 多 个 可 选 的 空白 。 如 
果 编 译 器 在 每 行 的 开头 找到 不 以 / 分 隔 符 或 % 分 隔 符 开 头 的 常见 模式 ， 则 它 将 
忽略 每 行 的 该 模式 。 

下 面 的 示例 阐释 了 这 些 规则 。 


e 以 下 注释 中 将 被 处 理 的 唯一 部 分 是 以 «summary» 开头 的 行 。 这 三 个 标记 格式 
产生 相同 的 注释 。 


/** &lt;summary&gt; text&lt;/summary&gt; */ 


Hire 
&lt;summary&gt; text&lt;/summary&gt ; 
ey 


ARES 
* &lt;summary&gt;text&lt;/summary&gt ; 
2 


e 编译 器 在 第 二 行 和 第 三 行 的 开头 标识 “的 常见 模式 。 该 模式 不 包括 在 输出 中 。 


Ves 
* &lt;summary&gt; 
* text &lt;/summary&gt ; */ 


。 编译 器 在 以 下 注释 中 找 不 到 任何 常见 模式 ， 因 为 第 三 行 的 第 二 个 字符 没有 星 
号 。 因 此 ， 第 二 行 和 第 三 行 中 的 所 有 文本 都 将 被 义理 为 注释 的 一 部 分 。 


hs 
* &lt;summary&gt; 
text &1t;/summary&gt; 
ay 


e 编译 器 之 所 以 在 此 注释 中 没 找到 任何 模式 有 以 下 两 个 原因 。 首 先 ， 星 号 前 的 空 
格 数 并 不 一 致 。 其 次 ， 第 五 行 是 以 Tab 开头 的 ， 它 并 不 等 效 于 空格 。 因 此 ， 从 
第 二 行 到 第 五 行 的 所 有 文本 都 将 被 处 理 为 注释 的 一 部 分 。 


Yew 
* &lt;summary&gt; 
* text 
* text2 
* &1t;/summaryégt; 
n 
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如 何 : 使 用 XML 文档 功能 (CH 编程 指 两 ) 


下 面 的 示例 提供 文档 类 型 的 基本 概述 。 


// If compiling from the command line, compile with: /doc:YourFile! 


/// 
/// 
/// 
ON 
/// 


<summary> 

Class level summary documentation goes here.</summary> 
<remarks> 

Longer comments can be associated with a type or member througl 
the remarks tag.</remarks> 


public class TestClass : TestInterface 


( 


/// «summary» 
/// Store for the name property.</summary> 
private string name - null; 


/// «summary» 
/// The class constructor. </summary> 
public TestClass() 


// TODO: Add Constructor Logic here. 
j 


/// «summary» 

/// Name property. </summary> 

/// «value» 

/// A value tag is used to describe the property value.</value: 
public string Name 


{ 
get 
{ 
if (_name == null) 
{ 
throw new System.Exception("Name is null"); 
j 
return name; 
j 
j 


/// «summary» 

/// Description for SomeMethod.</summary> 

/// <param name="s"> Parameter description for s goes here.</pé 
/// <seealso cref="System.String"> 

/// You can use the cref attribute on any tag to reference a t» 
/// and the compiler will check that the reference exists. «/st 
public void SomeMethod(string s) 

t 

j 


} 


/// 
/// 
/// 
/// 
/// 
/// 


/// <summary> 

/// Some other method. </summary> 

/// <returns> 

/// Return results are described through the returns tag.</rett 
/// <seealso cref="SomeMethod(string)"> 

/// Notice the use of the cref attribute to reference a specif: 
public int SomeOtherMethod( ) 


{ 
return 0; 
} 
public int InterfaceMethod(int n) 
{ 
return n * n; 
} 


/// «summary» 
/// The entry point for the application. 
/// </summary> 
/// «param name="args"> A list of command line arguments.</paré 
static int Main(System.String[] args) 
{ 
// TODO: Add code to start application here. 
return 0; 


<summary> 

Documentation that describes the interface goes here. 
</summary> 

<remarks> 

Details about the interface go here. 

</remarks> 


interface TestlInterface 


{ 


E — 


/// <summary> 

/// Documentation that describes the method goes here. 
/// </summary> 

/// <param name="n"> 

/// Parameter n requires an integer argument. 

/// «/param» 

/// «returns» 

/// The method returns an integer. 

/// «/returns» 

int InterfaceMethod(int n); 





// 此 .xml 文件 生成 了 与 上 面 的 代码 示例 。<?xml version="1.0"?> 
<doc> 
<assembly> 
namexmlsampleAMP_LT/nameAMP_GT 
</assembly> 
<members> 
member name="T:SomeClass" 
<summary> 
Class level summary documentation goes here.</summary> 
<remarks> 
Longer comments can be associated with a type or membei 
通过 注释 tagAMP LT/remarksAMP. GT 
</member> 
member name="F:SomeClass.m_Name" 
<summary> 
名 称 的 propertyAMP LT/summaryAMP GT 存储 
</member> 
member name="M:SomeClass.#ctor" 
summary% constructor .AMP_LT/SummaryAMP_GT 
</member> 
member name="M:SomeClass.SomeMethod(System.String)" 
<summary> 
Description for SomeMethod.</summary> 
param name="s" 中 的 参数 声明 转 到 hereAMP LT/paramAMP GT 
«seealso cref="T:System.String"> 
You can use the cref attribute on any tag to reference 
and the compiler will check that the reference exists.- 
</member> 
member name="M:SomeClass.SomeOtherMethod" 
<summary> 
Some other method.</summary> 
<returns> 
Return results are described through the returns tag.<, 
seealso cref="M:SomeClass.SomeMethod(System.String)" 
通知 使 用 cref 特性 引用 特定 方法 AMP_LT/seealsoAMP_GT 
</member> 
member name="M:SomeClass.Main(System.String[])" 
<summary> 
The entry point for the application.</summary> 
param name="args" 命令 行 argumentsAMP LT/paramAMP GT 43 
</member> 
member name="P:SomeClass.Name" 
<summary> 
name 属性 AMP_LT/summaryAMP_GT 
<value> 
值 标记 用 于 描述 属性 valueAMP LT/valueAMP GT 
</member> 
</member s> 
</doc> 


«| NE 








编译 代码 
若 要 编译 该 示例 ， 请 键 人 以 下 命令 行 : 
csc XMLsample.cs /doc:XMLsample.xml 


这 将 创建 XML 文件 XMLsample.xml， 使 用 类 型 的 命令 ， 您 可 以 在 浏览 器 或 。 


可 靠 编程 


XML 文档 以 W 开头 。 当 您 创建 新 项 目 时 ， 该 向 导 为 您 放置 一 些 起 始 /// 行 。 对 这 些 
注释 的 处 理 有 一 些 限制 : 


e 文档 必须 是 格式 良好 的 XML, WR XML 格式 不 正确 ， 将 生成 警告 ， 并 且 文 档 
文件 将 包含 FA 添加 的 注释 遇 到 错 ; 误 。 


e 开发 人 员 可 自由 创建 自己 的 标记 集 。 具 有 建议 的 标记 集 (请 参见 其 他 阅读 材料 
部 分 )。 某 些 建 议 的 标记 具有 特殊 含义 : 


o <param> 标记 用 于 描述 参数 。 如 果 使 用 ，s we 存在 ， 以 
及 文档 中 是 否 描述 了 所 有 参数 。 如 果 验 证 失败 ，4 编译 器 会 发 出 警告 。 


cref 特性 可 以 附加 到 任意 标记 ， 以 提供 对 代码 元 素 的 引用 。 编 译 器 将 验证 
该 代码 元 素 是 否 存在 。 如 果 验 证 失败 ， 编 译 器 会 发 出 警告 。 编 译 器 在 查找 
cref 特性 中 描述 的 类 型 时 ， 会 考虑 所 有 的 using 语句 。 


o <summary> 标记 由 Visual Studio 内 的 “Intellisense” 使 用 ， 用 来 显示 类 型 
或 成 员 的 其 他 相关 信息 。 


o 


ye 
Ef TER 


Ae 文件 不 提供 有 关 类 型 和 成 员 的 完整 信息 (例如 ， 它 不 包含 任何 类 型 信息 )。 
要 获得 有 关 类 型 或 成 员 的 完整 信息 ， 文 档 文件 必须 与 实际 关 型 或 成 员 上 的 反 
^is 起 使 用 ; 


请 


" 


阅 
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CHES 


这 部 分 提供 有 关 C# 关键 字 、 运 算 符 、 编 译 器 错误 和 警告 的 参考 资料 。 


本 节 内 容 


CHART 

提供 指向 有 关 CH 关键 字 和 语法 的 信息 的 链接 。 
C# 运算 符 

提供 指向 有 关 C# 运算 符 和 语法 的 信息 的 链接 。 
CH ias iR 


提供 指向 有 关 在 CHEN 25 t C1 8A Hr FY 2s 1 2 Op B] SB t f 
C£ Compiler Options 

包括 有 关 编 译 器 选项 以 及 如 何 使 用 这 些 选 项 的 信息 。 

C£ Compiler Errors 

包含 一 些 代 码 段 ， 演 示 C# 编译 器 错误 和 和 警告 的 原因 以 更 正方 法 。 

CH 语言 规范 


提供 一 些 链接 ， 供 获取 Microsoft Word 格式 的 最 新 版 本 的 C# 语言 规范 。 


相关 章节 


C# FAQ 
在 C# Developer Center 中 提供 内 容 不 断 增 加 的 C# 常见 问题 列表 。 


C# KB articles in the Microsoft Knowledge Base (Microsoft 知识 库 中 的 C# KB X 
=) 


打开 Microsoft 搜索 页 可 以 搜索 MSDN 提供 的 知识 库 文章 。 
Visual C# 

提供 Visual C# 文档 门户 网 站 。 

<paveover>C# Sample Applications 


提供 Visual C 示例 的 列表 和 有 关 如 何在 本 地 磁盘 上 查找 这 些 示 例 的 说 明 。 


使 用 Visual C# 开发 环境 

提供 一 些 链接 ， 这 些 链接 指向 描述 IDE 和 编辑 器 的 概念 性 主题 及 任务 主题 。 
C# 编程 指南 

包括 关于 如 何 使 用 C# 编程 语言 的 信息 。 


Ci KRF 


关键 字 是 对 编译 器 具有 特殊 意义 的 预定 义 保 留 标识 符 。 它 们 不 能 在 程序 中 用 作 标 识 
符 ， 除 非 它们 有 一 个 @ 前 级 。 例 如 ，@if 是 有 效 的 标识 符 ， 但 if 不 是 ， 因 为 if 是 
关键 字 。 


本 主题 中 的 第 一 个 表 列 出 的 关键 字 在 C# 程序 的 任何 部 分 都 是 保留 标识 符 。 本 主题 
中 的 第 二 个 表 列 出 了 CH 中 的 上 下 文 关键 字 。 上 下 文 关键 字 仅 在 受 限 制 的 程序 上 下 
文中 具有 特殊 含义 ， 并 且 可 在 该 上 下 文 外 部 用 作 标 识 符 。 通 常 ， 在 将 新 关键 字 添加 
到 C# 语言 的 同时 ， 也 会 将 它们 添加 为 上 下 文 关键 字 ， 以 便 避 免 破 坏 用 该 语言 的 早 
期 版 本 编写 的 程序 。 


abstract as base bool 
break byte case catch 

char checked class const 
continue decimal default Delegate 一 委托 
do double else enum 

事件 explicit extern false 
finally fixed float for 
foreach goto if implicit 

in in 〈 泛 型 修饰 符 ) int interface 
internal 为 lock long 

命名 空间 ^ new null 对 象 
operator out out 〈 泛 型 修饰 符 ) override 
params private protected public 
readonly ref return sbyte 
sealed short sizeof stackalloc 
static string struct switch 

this throw true try 

typeof uint ulong unchecked 
unsafe ushort using virtual 

void volatile while 


m L- Z 本 


NAQ TANI CH ze XB 16 uu 
MSDN CZ 289 ETE PA 


0 
Qo 
| 
7 
| 
H 
[ 
NO 
© 
on 
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上 下 文 关键 字 用 于 提供 代码 中 的 特定 含义 ， 但 它 不 是 C# 中 的 保留 字 。 某 些 上 下 文 
关键 字 (如 partial 和 where) 在 两 个 或 更 多 个 上 下 文中 具有 特殊 含义 。 


添加 Alias 一 别名 ascending 
async 等 待 descending 
dynamic from get 
global group into 
join let orderby 
partial (类 型 ) partial (方法 ) remove 
select set value 
var where ( 泛 型 类 型 约束 ) where (查询 子 句 ) 
yield 
请 参阅 
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类 型 (CR 参考 ) 


CH 类 型 体系 包含 下 列 几 种 类 别 : 
。 值 类 型 
。 引 用 类 型 
e 指针 类 型 


值 类 型 的 变量 存储 数据 ， 而 引用 类 型 的 变量 存储 对 实际 数据 的 引用 。 引 用 类 型 也 称 
为 对 象 。 指 针 类 型 仅 可 用 于 unsafe 模式 。 


通过 委 箱 和 取消 装 箱 ， 可 以 将 值 类 型 转换 为 引用 类 型 ， 然 后 再 转换 回 值 类 型 。 除 了 
装 箱 值 类 型 外 ， 无 法 将 引用 类 型 转换 为 值 类 型 。 


本 节 还 介绍 void 类 型 。 


null， 这 意味 着 它们 能 存储 其 他 非 值 状态 。 有 关 更 多 信息 ， 请 参见 


C4 参考 

C# 编程 指南 

C# 关键 字 

类 型 参考 表 (CH 参考 ) 

强制 转换 和 类 型 转换 (CH 编程 指南 ) 
类 型 (CH 编程 指南 ) 


值 类 型 (C# SA) 


值 类 型 主要 由 两 类 组 成 : 
e 结构 
e PUE 
结构 分 为 以 下 几 类 : 
e Numeric (数值 ) 类 型 
o 整 型 
o 浮 点 型 
o decimal 
e bool 


e. 用 户 定义 的 结构 。 


值 类 型 的 主要 功能 


基于 值 类 型 的 变量 直接 包含 值 。 将 一 个 值 类 型 变量 赋 给 另 一 个 值 类 型 变量 时 ， 将 复 
制 包含 的 值 。 这 和 与 引用 类 型 变量 的 赋值 不 同 ， 引 用 类 型 变量 的 赋值 只 复制 对 对 象 的 
引用 ， 而 不 复制 对 象 本 身 。 

所 有 的 值 类 型 均 隐 式 派 生 自 System.ValueType。 


与 引用 类 型 不 同 ， 不 能 从 值 类 型 派生 出 新 的 类 型 。 但 与 引用 类 型 相同 的 是 ， 结 构 也 
可 以 实现 接口 。 


与 引用 类 型 不 同 ， 值 类 型 无 法 包含 null 值 。 但 是 ， 可 以 为 null 的 类 型 功能 允许 值 
类 型 分 配给 null, 


每 种 值 类 型 均 有 一 个 隐 式 的 默认 构造 画 数 来 初始 化 该 类 型 的 默认 值 。 有 关 值 类 型 的 
默认 值 的 信息 ， 请 参见 默认 值 表 。 


简单 类 型 的 主要 功能 
所 有 的 简单 类 型 (CH 语言 的 组 成 部 分 ) 均 为 .NET Framework 系统 类 型 的 别名 。 


例如 ，int 是 System.Int32 的 别名 。 有 关 完 整 的 别名 列表 ， 请 参见 UB (CH 
参考 ) 。 


编译 时 计算 操作 数 均 为 简单 关 型 常数 的 常数 表达 式 。 


可 使 用 文字 初始 化 简单 类 型 。 例 如 ,，“A” 是 char 类 型 的 文字 ， 而 2001 = int 类 型 
的 文字 。 


初始 化 值 类 型 


在 使 用 C# 中 的 局 部 变量 之 前 ， 必 须 对 其 进行 初始 化 。 例 如 ， 可 能 声明 未 进行 初始 
化 的 局 部 变量 ， 如 以 下 示例 所 示 : 


int myInt; 


那么 在 将 其 初始 化 之 前 ， 无 法 使 用 此 变量 。 可 使 用 下 列 语句 将 其 初始 化 : 


myInt = new int(); // Invoke default constructor for int type. 


此 语句 是 下 列 语句 的 等 效 语句 : 

myInt = 0; // Assign an initial value, © in this example. 
ee as &[ 
当然 ， 可 以 用 同一 个 语句 进行 声明 和 初始 化 ， 如 下 面 示例 所 示 : 


int myInt = new int(); 


e 或- 


int myInt = 0; 


使 用 new ix £F, SHAR ERHARD MERAH dp ERANA TE ESI 
HH, Rime beta OmAT mylnt, ARB BARMERA 4& BAT SR 
多 信息 ， 请 参见 默认 值 表 。 

对 于 用 户 定义 的 类 型 ， 使 用 new 来 调用 默认 构造 罚 数 。 例 如 ， 下 列 语句 调用 了 
Point 结构 的 默认 构造 函数 : 


Point p = new Point(); // Invoke default constructor for the struct 
[EJ E) 


此 调用 后 ， 该 结构 被 认为 已 被 明确 赋值 ; 也 就 是 说 该 结构 的 所 有 成 员 均 已 初始 化 为 
各 自 的 默认 值 。 


有 关 new 运算 符 的 更 多 信息 ， 请 参见 new。 
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有 关 格 式 化 数字 类 型 输出 的 信息 ， 请 参见 格式 化 数值 结果 表 。 
请 参阅 

CH 参考 

C 编程 指南 

CH 关键 字 

类 型 (CH 参考 ) 


类 型 参考 表 (CHEE) 
引用 类 型 (CHES) 


值 类 型 (C# BS) 


bool (C£ 参考 ) 


bool 关键 字 是 System.Boolean 的 别名 。 它 用 于 声明 变量 来 存储 布尔 值 true 和 
false。 


二 
Ej TER 


如 果 需 要 一 个 也 可 以 有 null 值 的 布尔 型 变量 ， 请 使 用 bool?。 有 关 更 多 信息 ， 
请 参见 可 以 为 null 的 类 型 (CH 编程 指南 ) o 


文本 


可 将 布尔 值 赋 给 bool 变量 。 也 可 以 笃 计 算 结 果 为 bool 类 型 的 表达 式 赋 给 bool X 


Ho 


E 


public class BoolTest 


{ 
static void Main() 
{ 
bool b = true; 
// WriteLine automatically converts the value of b to text 
Console.WriteLine(b); 
int days - DateTime.Now.DayOfYear; 
// Assign the result of a boolean expression to b. 
b = (days % 2 == 0); 
// Branch depending on whether b is true or false. 
if (b) 
{ 
Console.WriteLine("days is an even number"); 
j 
else 
Console.WriteLine("days is an odd number"); 
j 
} 
} 
/* Output: 
True 


days is an <even/odd> number 


=y 


= — Bl] 





bool 变量 的 默认 值 为 false。 bool? 交 量 的 默认 值 为 null。 


转换 


在 C++ rh, bool 类 型 的 值 可 转换 为 int 类 型 的 值 ; 也 就 是 说 ，false FAFSA, 
而 true 等 效 于 非 需 值 。 在 C# 中 ， 不 存在 bool 类 型 与 其 他 类 型 之 间 的 相互 转换 。 
例如 ， 下 面 的 if 语句 在 C# 中 无 效 : 


int x = 123; 
// if (x) // Error: "Cannot implicitly convert type 'int' to "bo 


Console.Write("The value of x is nonzero."); 





若 要 测试 int 类 型 的 变量 ， 必 须 将 该 变量 与 一 个 值 (例如 需 ) 进行 显 式 比较 ， 如 下 
所 示 : 

if (x != 0) // The C£ way 

1 


Console.Write("The value of x is nonzero."); 


在 此 例 中 ， 您 从 键盘 输入 一 个 字符 ， 然 后 程序 检查 输入 的 字符 是 否 是 一 个 字母 。 如 
果 字 符 是 一 个 字母 ， 则 程序 检查 它 是 大 写 还 是 小 写 。 这 些 检查 是 使 用 lsLetter 和 
IsLower (两 者 均 返 回 bool 类 型 ) 来 执行 的 : 


public class BoolKeyTest 
{ 


static void Main() 


{ 
Console Write( Enter a character: "); 
char c = (char )Console.Read(); 
if (Char.IsLetter(c) ) 


if (Char.IsLower(c) ) 
{ 


} 
else 
{ 
} 

} 

else 


{ 
} 


Console.WriteLine("The character is lowercase."); 


Console.WriteLine("The character is uppercase."); 


Console.WriteLine("Not an alphabetic character."); 
} 
} 
/* Sample Output: 
Enter a character: X 


The character is uppercase. 


Enter a character: x 
The character is lowercase. 


Enter a character: 2 
The character is not an alphabetic character. 
5 


JE ENSE xj 
C# 语言 规范 
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内 置 类 型 表 (CH 参考 ) 
fex UB HX (CES) 
显 陈 数值 转换 表 (CES) 


bool (CZ 参考 ) 593 


byte (Ct 参考 ) 


byte 关键 字 代表 一 种 整 型 ， 该 类 型 按 下 表 所 示 存 储 值 : 


类 型 范围 大 小 .NET Framework 类 型 
byte 0 到 255 无 符号 8 位 整数 System.Byte 


文本 
可 如 下 例 所 示 声 明 并 初始 化 byte 类 型 的 变量 : 


byte myByte = 255; 


在 以 上 声明 中 ， 整 数 255 M int 隐 式 转换 为 byte。 如 果 整 数 超出 了 byte 的 范围 ， 
将 产生 编译 错误 。 


转换 


存在 从 byte 到 short, ushort, int, uint, long, ulong, float, double 或 decimal 
的 预定 义 隐 式 转 换 。 


不 能 将 更 大 存储 大 小 的 非 文本 数值 类 型 隐 式 转换 为 byte。 有 关 整 型 的 存储 大 小 的 更 
多 信息 ， 请 参见 BER (C# 参考 ) 。 例 如 ， 请 看 以 下 两 个 byte Bx Aly: 


byte x = 10, y = 20; 


以 下 赋值 语句 将 产生 一 个 编译 错误 ， 原 因 是 赋值 运算 符 右 侧 的 算术 表达 式 在 默认 情 
况 下 的 计算 结果 为 int 类 型 。 


// Error: conversion from int to byte: 
byte z = X + y; 


若 要 解决 此 问题 ， 请 使 用 强制 转换 : 


// OK: explicit conversion: 
byte z - (byte)(x * y); 


但 是 ， 在 目标 变量 具有 相同 或 更 大 的 存储 大 小 时 ， 使 用 下 列 语句 是 可 能 的 : 


int x 10, y = 20; 
int m x + y; 
long Nn = x + y; 


同样 ， 不 存在 从 浮 点 型 到 byte 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转换 ， 
否则 以 下 语句 闻 生 成 一 个 编译 器 错误 : 


// Error: no implicit conversion from double: 
byte x = 3.0; 

// OK: explicit conversion: 

byte y = (byte)3.0; 


i i DE 
ll : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(byte b) {} 


使 用 byte 强制 转换 可 保证 调用 正确 的 类 型 ， 例 如 


// Calling the method with the int parameter: 
SampleMethod(5); 

// Calling the method with the byte parameter: 
SampleMethod((byte)5); 


有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 
有 关 隐 式 数 值 转 换 规则 的 更 多 信息 ， 请 参见 BUMMER 〈C# 参考 ) 。 


C# ; Ta 2S HM rel 


有 关 详 细 信 息 ， 请 参 阅 CH 语 B. 该 语 言 规范 Jb 2L 是 CH 语 法 和 用 法 的 权威 资料 。 


请 参阅 

Byte 

CHES 

C# 编程 指南 

CH 关键 字 
HUR (CH 参考 ) 
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内 置 类 型 表 (CH 参考 ) 
fex UB HX (CES) 
显 陈 数值 转换 表 (CES) 


byte (C£ 参考 ) 596 


char (C4 2) 


char 关键 字 用 于 声明 .NET framework 使 用 Unicode 字符 表示 System.Char 结构 
的 实例 。 Char 对 象 的 值 是 16 位 数字 (序号 值 。) 


Unicode 字符 在 世界 上 表示 大 多 数 书面 语言 。 


类 型 范围 大 小 .NET Framework 类 型 
char U+0000 到 U+FFFF 16 fi; Unicode 字符” System.Char 


文本 


char 类 型 的 常数 可 以 写成 字符 、 十 六 进 制 换 码 序列 或 Unicode 表示 形式 。 您 也 可 
以 显 式 转换 整数 字符 代码 。 在 下 面 的 示例 中 ， 四 个 char 变量 使 用 同一 字符 X 初始 
化 : 


char[] chars = new char[4]; 


chars[0] = 'X'; // Character literal 
chars[1] = 'Nx0058'; // Hexadecimal 

chars[2] = (char)88; // Cast from integral type 
chars[3] = 'Nu0058'; // Unicode 


foreach (char c in chars) 
Console.Write(c + " "); 


J 
7/7 Output: X X X X 


转换 


char 可 以 隐 式 转换 为 Ushort、int、uint、long、ulong、float、double 或 decimal. 
但 是 ， 不 存在 从 其 他 类 型 到 char 类 型 的 隐 式 转换 。 


System.Char 类 型 提供 几 个 处 理 char 值 的 静态 方法 。 
A ss 
C# 32 Bal 
有 关 详 细 信 息 ， 请 参阅 CZ 语言 规范 。 该 语 BÀ Jb 7L CH; te 知 法 和 用 法 的 权威 资料 。 
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Char 

C# BS 

C# 编程 指南 

C# 关键 字 

整 型 表 (CH 参考 ) 

内 置 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 

显 式 数值 转换 表 (CES) 

可 以 为 nul 的 类 型 (CH 编程 指南 ) 
字符 串 (CH 编程 指南 ) 


char (C# 参考 ) 


598 


decimal (C# 24) 


decimal 关键 字 指 示 128 位 数据 类 型 。 与 浮 点 型 相 比 ，decimal 类 型 具有 更 高 的 精 
度 和 更 小 的 范围 ， 这 使 它 适合 于 财务 和 货币 计算 。 decimal 类 型 的 大 致 范围 和 精度 
如 下 表 所 示 。 


类 型 大 致 范围 精度 .NET Framework 
Dy == 
= - B IN 
decimal (-7-9*1028-7.9x1028)/ 28-29 stem Decimal 


(100 - 28) 效 位 


文本 


如 果 和 希望 实数 被 视 为 decimal 类 型 ， 请 使 用 后 级 m 或 M， 例 如 : 


decimal myMoney = 300.5m; 
如 果 没有 后 级 m， 则 数字 将 被 视 为 double 类 型 并 会 生成 编译 器 错误 。 


转换 


整 型 将 被 隐 式 转换 为 decimal 类 型 ， 其 计算 结果 为 decimal。 因 此 ， 你 可 以 使 用 整 
数 文本 初始 化 十 进 制 变量 而 不 使 用 后 级 ， 如 下 所 示 : 


decimal myMoney = 300; 


在 浮 点 型 和 decimal 类 型 之 间 不 存在 隐 式 转换 ; 因此 ， 必 须 使 用 强制 转换 以 在 这 两 
个 类 型 之 间 转 换 。 例 如 : 


decimal myMoney = 99.9m; 
double x - (double)myMoney; 
myMoney = (decimal)x; 


你 还 可 以 在 同一 表达 式 中 混合 使 用 decimal 和 数值 整 型 。 但 是 ， 不 进行 强制 转换 就 
混合 使 用 decimal 和 浮 点 型 业 导 致 编译 错误 。 


有 关 隐 了 式 数 值 转换 的 更 多 信息 ， 请 参见 隐 式 数值 转换 表 (CES), 


有 关 显 式 数值 转换 的 更 多 信息 ， 请 参见 显 式 数值 转换 表 (C# 参考 ) 。 


设置 十 进 制 输 出 的 格式 


你 可 以 通过 使 用 String.Format 方法 或 Console.Write 方法 (其 调用 
String.Format()) 来 设置 结果 的 格式 。 货 币 格 式 是 使 用 标准 货币 格式 字符 
ER"C"sX"c"3H T 如 本 文 后 面 的 第 二 个 示例 所 示 。 有 关 String.Format 方法 的 更 


多 信息 ， 请 参见 String.Format。 


下 面 的 示例 尝试 添加 double 和 decimal 变量 ， 这 会 导致 编译 器 错误 。 


double dub = 9; 

// The following line causes an error that reads "Operator '+' canr 
// operands of type 'double' and 'decimal'" 

Console.WriteLine(dec + dub); 


// You can fix the error by using explicit casting of either operar 
Console.WriteLine(dec + (decimal)dub); 
Console.WriteLine((double)dec + dub); 
jp 
结果 为 以 下 错误 : 


Operator '+' cannot be applied to operands of type 'double' and 'decimal' 


在 此 示例 中 ， 同 一 个 表达 式 中 混合 使 用 了 decimal 和 int. +R decimal X 
型 。 





public class TestDecimal 


( 


static void Main() 


decimal d = 9.1m; 
int y = 3; 
Console.WriteLine(d + y); // Result converted to decimal 


} 
} 
// Output: 12.1 
Aoo ë ël 


T 通过 使 用 货币 格式 字符 串 来 设置 输出 的 格式 。 请 注意 ，x RBA, 
其 小 数位 数 超出 了 $0.99。 表 示 最 大 精确 位 数 的 变量 y 严格 按照 正确 的 格式 显 


public class TestDecimalFormat 


{ 
static void Main() 
{ 
decimal x = 0.999m; 
decimal y = 9999999999999999999999999999m; 
Console.WriteLine("My amount = {0:C}", x); 
Console.WriteLine("Your amount = {0:C}", y); 
} 
} 
/* Output: 


My amount = $1.00 
Your amount = $9,999,999, 999,999,999, 999, 999, 999, 999.00 
Sy 


vp = n < 
CH j2 543 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

Decimal 

C# 参考 
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CH 关键 字 

整 型 表 (CH 参考 ) 
HEXER (CSS) 

隐 式 数值 转换 表 (CH 参考 ) 
显 式 数值 转换 表 (CH 参考 ) 
标准 数字 格式 字符 串 


double (C# 24) 


double 关键 字 表 示 存 储 64 位 浮 点 值 的 简单 类 型 。 下 表 显 示 了 double 类 型 的 精度 
和 大 致 范围 。 


类 型 大 致 范围 精度 .NET Framework 类 
ass 5l Z] 
double: | 29.9.5 10-929 S MEIN 158116 ^ svstem.Double 


10308 位 


文本 


默认 情况 下 ， 赋 值 运算 符 右 侧 的 实数 被 视 为 double。 但 是 ， 如 果 希 望 整数 被 视 为 
double， 请 使 用 后 级 d 或 D， 例 如 : 


double x = 3D; 


转换 
可 在 一 个 表达 式 中 兼用 数值 整 型 和 浮 点 型 。 在 此 情况 下 ， 整 型 将 转换 为 浮 点 型 。 根 
据 以 下 规则 计算 表达 式 : 


e 如 果 其 中 一 个 浮 点 类 型 为 double， 则 表达 式 的 计算 结果 为 double 或 
bool (在 关系 表达 式 或 布尔 表达 式 中 ) 。 


e 如 果 表 达 式 中 不 存在 double 类 型 ， 则 表达 式 的 计算 结果 为 float K bool (在 
关系 表达 式 或 布尔 表达 式 中 ) o 


浮 点 表达 式 可 以 包含 下 列 值 集 : 
e ESHS. 
。 正 无 穷 和 负 无 穷 。 
e. 非 数 字 值 (NaN)。 
e 有 限 的 非 雳 值 集 。 


有 关 这 些 值 的 更 多 信息 ， 请 参见 IEEE 网 站 上 的 “IEEE Standard for Binary 
Floating-Point Arithmetic” (二进制 浮 点 算法 的 IEEE 标准 ) 。 


在 下 面 的 示例 中 ， 一 个 int、 一 个 short、 一 个 float 和 一 个 double 相 加 ， 计 算 结 果 
为 double 类 型 。 


// Mixing types in expressions 
class MixedTypes 
{ 

static void Main() 


{ 


—h 
| 
o 
feb) 
ct 
Nx Il 


ZI TENE P 
short 5 
double w = 1.7E+3; 
// Result of the 2nd argument is a double: 
Console.WriteLine("The sum is {0}", x * y +z +w); 


j 


// Output: The sum is 1712.5 


cm 4+ 
C# 4 5AE 
有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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CH 关键 字 

默认 值 表 (CH 参考 ) 
HEXER (CAS) 

浮 点 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH SA) 
显 式 数 值 转换 表 (CHA) 


enum (CZ 参考 ) 
enum Xt PRI AOR, RI— Huh aA RRN A T Boc RAR 
类 型 。 


通常 情况 下 ， 最 好 是 在 命名 空间 内 直接 定义 枚 举 ， 以 便 该 命名 空间 中 的 所 有 类 都 能 
够 同样 方便 地 访问 它 。 但 是 ， 还 可 以 将 枚 举 谋 套 在 类 或 结构 中 。 


默认 情况 下 ， 第 一 个 枚 举 数 的 值 为 0， 后面 每 个 枚 举 数 的 值 依次 递增 1。 例 如 ， 下 
面 的 枚 举 ，Sat 是 0，Sun 是 1，Mon 是 2 等 . 


enum Days (Sat, Sun, Mon, Tue, Wed, Thu, Fri}; 
如 下 面 的 示例 所 示 枚 举 数 可 用 初始 值 来 重 写 默认 值 。 
enum Days {Sat=1, Sun, Mon, Tue, Wed, Thu, Fri}; 


在 此 枚 举 中 ， 强 制 元 素 序 列 从 1 而 不 是 0 开始 。 但 是 ， 一 般 建议 包括 值 为 0 的 常 
量 。 有 关 更 多 信息 ， 请 参见 枚 举 类 型 (CH 编程 指南 ) o 

每 种 枚 举 类 型 都 有 基础 类 型 ， 该 类 型 可 以 是 除 char 以 外 的 任何 整 型 。 枚 举 元 素 的 
默认 基础 类 型 为 int。 要 声明 另 一 整 型 枚 举 (如 byte) ， 请 在 标识 符 之 后 紧 跟 类 
型 ， 然 后 再 使 用 冒号 ， 如 下 面 的 示例 所 示 。 


enum Days : byte (Sat-1, Sun, Mon, Tue, Wed, Thu, Fri); 


准许 使 用 的 枚 举 类 型 有 byte、sbyte、short、ushort、int、uint、long 或 ulong. 


可 以 给 Days 类 型 的 变量 赋 以 基础 类 型 范围 内 的 任何 值 ， 所 赋 的 值 不 限于 已 命名 的 
常数 。 


enum E 的 默认 值 为 表达 式 (E)0 生成 的 值 。 
8 注意 
枚 举 数 的 名 称 中 不 能 包含 空白 。 
基础 类 型 指定 为 每 个 枚 举 数 分 配 的 存储 大 小 。 但 是 ， 从 enum 类 型 到 整 型 的 转换 需 


要 用 显 式 类 型 转换 来 完成 。 人 例如， 下面 的 语句 使 用 强制 转换 (M enum 转换 为 
int) 将 枚 举 数 Sun 赋值 给 一 个 int 类 型 的 变量 。 


int x - (int)Days.Sun; 


将 System.FlagsAttribute 应 用 于 某 个 枚 举 时 ， 如 果 该 枚 举 包 含 一 些 使 用 按 位 OR 运 
算 组 合 的 元 素 ， 该 特性 在 用 于 某 些 工具 时 会 影响 enum 的 行为 。 当 使 用 诸如 
Console 类 方法 、 表 达 式 计算 器 这 样 的 工具 时 ， 可 以 注意 到 这 些 变 化 。 (请 参见 第 
三 个 示例 。) 


可 靠 编 程 
与 任何 常量 一 样 ， 对 枚 举 中 各 个 值 的 所 有 引用 在 编译 时 均 将 转换 为 数值 文本 。 这 可 
形成 潜在 的 版 本 控制 问题 ， 如 常量 (C# 编程 指南 ) 中 所 述 。 


给 新 版 本 的 枚 举 赋 其 他 值 ， 或 者 更 改 新 版 本 中 枚 举 成 员 的 值 ， 可 导致 相关 源 代 码 出 
现 问题 。 通 常 在 switch 语句 中 使 用 枚 举 值 。 如 果 enum 类 型 中 添加 了 其 他 元 素 ， 
则 switch 语句 的 默认 节 可 能 被 意外 选 定 。 


如 果 其 他 开发 人 员 使 用 您 的 代码 ， 则 需要 提供 相关 说 明 ， 告 诉 开发 人 员 如 果 任 何 
enum 类 型 中 添加 了 新 元 素 ， 他 们 的 代码 应 该 如 何 响应 。 


在 下 面 的 示例 中 ， 将 声明 枚 举 Days。 两 个 枚 举 数 被 显 式 转换 为 整数 并 赋 给 整 型 变 
E9 


public class EnumTest 


{ 
enum Days { Sun, Mon, Tue, Wed, Thu, Fri, Sat }; 
static void Main() 
{ 
int x = (int)Days.Sun; 
int y = (int)Days.Fri; 
Console.WriteLine("Sun = (0)", x); 
Console.WriteLine("Fri = (0)", y); 
} 
} 
/* Output: 
Sun = 0 
Fri = 5 
is 


在 下 面 例 中 ， 使 用 了 基 类 选项 来 声明 long 类 型 的 enum 成 员 。 请 注意 ， 即 使 枚 举 
的 基础 类 型 是 long， 也 仍然 必须 使 用 强制 转换 将 枚 举 成 员 显 式 转换 为 long 类 型 。 


public class EnumTest2 


{ 
enum Range : long { Max = 2147483648L, Min = 255L }; 
static void Main() 
{ 
long x = (long)Range.Max; 
long y = (long)Range.Min; 
Console.WriteLine("Max = {0}", x); 
Console.WriteLine("Min = {0}", y); 
} 
} 
/* Output: 
Max = 2147483648 
Min = 255 
ay 


下 面 的 代码 示例 阅 释 enum 声明 上 的 System.FlagsAttribute 特性 的 使 用 和 效果 。 


// Add the attribute Flags or FlagsAttribute. 
[Flags] 
public enum CarOptions 
{ 
// The flag for SunRoof is 0001. 
SunRoof = 0x01, 
// The flag for Spoiler is 0010. 
Spoiler = 0x02, 
// The flag for FogLights is 0100. 
FogLights = 0x04, 
// The flag for TintedWindows is 1000. 
Tintedwindows = 0x08, 


} 
class FlagTest 
{ 
static void Main() 
{ 
// The bitwise OR of 0001 and 0100 is 0101. 
CarOptions options = CarOptions.SunRoof | CarOptions.FogLit 
// Because the Flags attribute is specified, Console.Writel 
// the name of each enum element that corresponds to a flac 
// the value 1 in variable options. 
Console.WriteLine(options); 
// The integer value of 0101 is 5. 
Console.WriteLine((int)options); 
} 
} 
/* Output: 
SunRoof, FogLights 
5 
n 


Ul nrme— a 
注释 


如 果 您 移 除 Flags， 则 示例 将 显示 以 下 值 : 


有 关 详 细 信 息 ， 请 参阅 C# 语 羊 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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enum (C£ 参考 ) 
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float (CH 参考 ) 


float 关键 字 表 示 存 储 32 位 浮 点 值 的 简单 类 型 。 下 表 显 示 了 float 类 型 的 精度 和 大 
致 范围 。 


类 型 大 致 范围 精度 .NET Framework 类 型 
float | -3.4 x 1038 到 +3.4 x 1038 7 位 System.Single 


文本 


默认 情况 下 ， 赋 值 运算 符 右 侧 的 实数 被 视 为 double。 因 此 ， 应 使 用 后 组 和 或 F 初始 
化 浮 点 型 变量 ， 如 以 下 示例 中 所 示 : 


float x = 3.5F; 


如 果 在 以 上 声明 中 不 使 用 后 级 ， 则 会 因为 您 党 斌 将 一 个 double 值 存 储 到 float 变量 
中 而 发 生 编 译 错 误 。 


转换 
可 在 一 个 表达 式 中 兼用 数值 整 型 和 浮 点 型 。 在 此 情况 下 ， 整 型 将 转换 为 浮 点 型 。 根 
据 以 下 规则 计算 表达 式 : 


e 如 果 其 中 一 个 浮 点 型 为 double， 则 表达 式 的 计算 结果 为 double 或 bool. (EX 
系 表 达 式 或 布尔 表达 式 中 ) 。 


e 如 果 表 达 式 中 不 存在 double 类 型 ， 则 表达 式 的 计算 结果 为 float 或 bool (在 关 
系 表 达 式 或 布尔 表达 式 中 ) 。 


浮 点 表达 式 可 以 包含 下 列 值 集 : 
e ESAS 
e EDRAM f 55 
e FER (& (NaN) 
e 有限 的 非 雳 值 集 


有 关 这 些 值 的 更 多 信息 ， 请 参见 IEEE 网 站 上 的 “IEEE Standard for Binary 
Floating-Point Arithmetic” (二进制 浮 点 算法 的 IEEE 标准 ) 。 


在 下 面 的 示例 中 ， 包 含 int、short 和 float 类 型 的 数学 表达 式 得 到 一 个 float 结果 。 
(请 记 住 float 是 System.Single 类 型 的 别名 。) 请 注意 ， 表 达 式 中 没有 double, 


class FloatTest 


{ 
static void Main() 
{ 
int x = 3; 
float y = 4.5f; 
short z = 5; 
var result = x * y / Z; 
Console.WriteLine("The result is {0}", result); 
Type type = result.GetType(); 
Console.WriteLine("result is of type {0}", type.ToString(). 
} 
} 
/* Output: 


The result is 2.7 
result is of type System.Single //'float' is alias for 'Single' 





有 关 详 细 信 息 ， 请 参阅 C# 语言 规 沁 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 
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强制 转换 和 类 型 转换 (CH 编程 指南 ) 
C# 关键 字 

BRR (CH 参考 ) 

内 置 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 

显 式 数 值 转换 表 (CH 参考 ) 


int (C# 参考 ) 


int 关键 字 表 示 一 种 整 型 ， 该 关 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 


类 .NET Framework ”默认 
型 3B. H3] 大 小 类 型 " 

; -2,147,483,648 到 有 符号 32 位 

int 2 147 483,647 整数 System.Int32 0 


文本 


可 以 声明 并 初始 化 int 类 型 的 变量 ， 例 如 : 
int i = 123; 


如 果 整 数 没 有 后 级 ， 则 其 类 型 为 以 下 类 型 中 可 表示 其 值 的 第 一 个 类 
型 : int、uint、long、ulong。 在 此 例 中 为 int 类 型 。 


转换 


存在 从 int 到 long, float, double 或 decimal 的 预定 义 隐 式 转换 。 例 如 : 


// '123' is an int, so an implicit conversion takes place here: 
float f - 123; 


存在 从 sbyte, byte, short, ushort 或 char 到 int 的 预定 义 隐 式 转 换 。 例 如 ， 如 果 
不 进行 强制 转换 ， 下 面 的 赋值 语句 将 产生 编译 错误 : 


long aLong = 22; 
int i1 - aLong; // Error: no implicit conversion from long. 
int i2 - (int)aLong; // OK: explicit conversion. 


"ee 


还 请 注意 ， 不 存在 从 浮 点 型 到 int 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转 
换 ， 否 则 以 下 语句 将 生成 一 个 编译 器 错误 : 


int x = 3:07 // Error: no implicit conversion from 
int y = (int)3.0; // OK: explicit conversion. 


了 ER 
有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 更 多 信息 ， 请 参见 float 和 doubles 
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long (C£ 2) 


long 关键 字 表 示 一 种 整 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 


.NET 
类 型 范围 大 小 Framework 
类 型 
-9,223,372,036,854,775,808 到 有 符号 64 
long 9 223 372,036,854,775,807 位 整数 elem 


文本 


可 如 下 例 所 示 声 明 并 初始 化 long 类 型 的 变量 : 


long longi = 4294967296; 


如 果 整 数 没有 后 级 ， qon ndn e tf BUE — 
型 :int、uint、long、ulong。 在 上 例 中 ， 它 是 long 类 型 ， m SEHT uint 的 范 
E (有 关 整 型 的 存储 大 小 ， 请 参见 SEX (Cs 参考 ) ) 。 


还 可 以 像 下 面 这 样 ， 在 long 类 型 中 使 用 后 级 L 


long long2 = 4294967296L; 


当 使 用 后 级 上 时 ， 将 根据 整数 的 大 小 确定 它 的 类 型 为 long 还 是 ulong。 在 此 例 
中 ， 它 是 long， 因 为 它 小 于 ulong 的 范围 的 下 限 。 


BARAT RAB RAK. MAFTAH long 和 int 参数 的 重 载 方法 为 例 : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(long 1) {} 


使 用 后 级 上 可 保证 调用 正确 的 类 型 ， 例 如 : 


SampleMethod(5); // Calling the method with the int parameter 
SampleMethod(5L); // Calling the method with the long parameter 


Ki = :] 








可 在 同一 个 表达 式 中 同时 使 用 long 类 型 和 其 他 数值 整 型 ， 这 时 表达 式 的 计算 结 
A long 《在 关系 表达 式 或 布尔 :表达 式 中 为 bool) 类 型 。 例 如 ， DR aie 


long : 


898L + 88 


jT = 
Ef TER 


也 可 用 小 写字 母 中 作 后 级。 但 是 ， 因 为 字母 路 容易 与 数字 “1" 混 淆 ， 会 生成 编译 
HERE. QUERER. MERI. 


有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 


转换 


存在 从 long 到 float, double 或 decimal 的 预定 义 隐 式 转换 。 其 他 情况 下 必须 使 用 
显 式 转 换 。 例 如 ， 不 使 用 显 式 类 型 转换 时 ， 下 列 语句 将 产生 编译 错误 : 


int x 
int x 


8L; // Error: no implicit conversion from long to ir 
(int)8L; // OK: explicit conversion to int 


E NE SSS 





存在 从 sbyte, byte, short, ushort, int, uint & char 到 long 的 预定 义 隐 式 转 
换 。 


还 请 注意 ， 不 存在 从 浮 点 型 到 long 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转 
换 ， 否 则 以 下 语句 将 生成 一 个 编译 器 错误 : 


long x = 3.0; // Error: no implicit conversion fror 
long y = (long)3.0; // OK: explicit conversion 


ml = = 





A s 

CH j2 SAS 
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long (C£ 参考 ) 615 


sbyte (Ct 参考 ) 


sbyte 关键 字 表 示 一 种 整 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 


类 型 范围 大 小 .NET Framework 类 型 
sbyte -128 到 127 有 符号 8 位 整数 System.SByte 


可 使 用 下 述 方法 声明 并 初始 化 sbyte 类 型 的 变量 : 
sbyte sByte1 = 127; 


在 以 上 声明 中 ， 整 数 127 M int 隐 式 转换 为 sbyte。 如 果 整 数 超出 了 sbyte 的 范 
用， 将 产生 编译 错误 。 

i 以 下 面 使 用 sbyte 和 int 参数 的 重 载 方 法 为 
9 : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(sbyte b) {} 


使 用 sbyte 强制 转换 可 保证 调用 正确 的 类 型 ， 例 如 : 


// Calling the method with the int parameter: 
SampleMethod(5); 

// Calling the method with the sbyte parameter: 
SampleMethod((sbyte)5); 


转换 


存在 从 sbyte 到 short, int, long. float, double 或 decimal 的 预定 义 隐 式 转 换 。 


能 将 存储 大 小 更 大 的 非 文本 数值 类 型 隐 式 转换 为 sbyte 类 型 《有关 整 型 的 存储 大 
小 的 信息 | 请 参见 BER (C# 人 参考) ) 。 例 如 ， 请 看 以 下 两 个 sbyte 变量 x 和 
y: 


sbyte x - 10, y - 20; 


以 下 赋值 语句 将 产生 一 个 编译 错误 ， 原 因 是 赋值 运算 符 右 侧 的 算术 表达 式 在 默认 情 
况 下 的 计算 结果 为 int。 


sbyte z =x + y; // Error: conversion from int to sbyte 


若 要 更 正 此 问题 ， 请 对 该 表达 式 执 行 强制 转换 ， 如 下 例 所 示 : 


sbyte z = (sbyte)(x + y); // OK: explicit conversion 


但 是 ， 在 目标 变量 具有 相同 或 更 大 的 存储 大 小 时 ， 使 用 下 列 语句 是 可 能 的 : 


sbyte x = 10, y = 20; 
int m = X + y; 
long Nn = x + y; 


还 请 注意 ， 不 存在 从 浮 点 型 到 sbyte 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转 
换 ， 否 则 以 下 语句 将 生成 一 个 编译 器 错误 : 


sbyte x = 3.0; // Error: no implicit conversion fr« 
sbyte y = (sbyte)3.0; // OK: explicit conversion 


4 m = 
有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double. 
有 关 隐 式 数值 转换 规则 的 更 多 信息 ， 请 参见 隆 式 数值 转换 表 (C# 参考 ) 。 
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short (C£ 参考 ) 


short 关键 字 表 示 一 种 整数 数据 类 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 


类 型 范围 大 小 .NET Framework 类 型 


short -32,768 到 32,767 ”有 符号 16 位 整数 ^ System.Int16 


文本 


可 如 下 例 所 示 声 明 并 初始 化 short 类 型 的 变量 : 
short x = 32767; 


在 以 上 声明 中 ， 整 数 32767 从 int 隐 式 转换 为 short, 如 果 整 数 的 长 度 超过 了 
short 存储 位 置 的 大 小 ， 则 将 产生 编译 错误 。 

a 以 下 面 使 用 short 和 int 参数 的 重 载 方 法 为 
9l : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(short s) {} 


使 用 short 强制 转换 可 保证 调用 正确 的 类 型 ， 例 如 : 


SampleMethod(5); // Calling the method with the int paramet 
SampleMethod((short)5); // Calling the method with the short parar 


转换 


存在 从 short 到 int, long, float, double 或 decimal 的 预定 义 隐 式 转换 。 


不 能 将 存储 大 小 更 大 的 非 文本 数值 类 型 隐 式 转换 为 short 类 型 《有 关 整 型 的 存储 大 
小 的 信息 ， 请 参见 IEEE (C# 参考 ) ) 。 例如 ， 请 看 以 下 两 个 short 变量 x 和 
y: 





short x = 5, y = 12; 


以 下 赋值 语句 将 产生 一 个 编译 错误 ， 原 因 是 赋值 运算 符 右 侧 的 算术 表达 式 在 默认 情 
况 下 的 计算 结果 为 int 类 型 。 


short z = x + y; // Error: no conversion from int to short 
若 要 解决 此 问题 ， 请 使 用 强制 转换 : 
short z = ( short )(x + y); // OK: explicit conversion 


但 是 ， 在 目标 变量 具有 相同 或 更 大 的 存储 大 小 时 ， 使 用 下 列 语句 是 可 能 的 : 


int m = X + y; 
long n=x+ y; 


不 存在 从 浮 点 型 到 short 类 型 的 隐 式 转换 。 例如 ， 除 非 使 用 显 式 强 制 转 换 ， 否 则 以 
下 语句 闻 生 成 一 个 编译 器 错误 : 


short x = 3.0; // Error: no implicit conversion fi 
short y - (short)3.0; // OK: explicit conversion 


EE 
有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 
有 关 隐 式 数值 转换 规则 的 更 多 信息 ， 请 参见 Ex Aue (CHO), 





CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 


请 参阅 

Int16 

C# 参考 

C# 编程 指南 

CH 关键 字 

整 型 表 (CH 参考 ) 

内 置 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 
显 式 数值 转换 表 (C# 参考 ) 


struct (C# 参考 ) 


struct X Zize— fh X 2EU, A AARRE X mun, PIM, ABIÉBUAAES E 
存 商 品 的 特征 。 下 面 的 示例 显示 了 一 个 简单 的 结构 声明 : 
public struct Book 
public decimal price; 


public string title; 
public string author; 


备注 

结构 还 可 以 包含 构造 画 数 、 常 量 、 字 段 、 方 法 、 属 性 、 索 引 器 、 运 算 符 、 事 件 和 嵌 
套 关 型 ， 但 如 果 同 时 需要 上 述 几 种 成 员 ， 则 应 当 考虑 改 为 使 用 类 作为 类 型 。 

有 关 示 例 ， 请 参阅 使 用 结构 (CH 编程 指南 ) 。 


结构 可 以 实现 接口 ， 但 它们 无 法 继承 另 一 个 结构 。 因 此 ， 结 构成 员 无 法 声明 为 
protected。 


有 关 详 细 信 息 ， 请 人 参阅 结构 (CH 编程 指南 ) o 


示例 


有 关 示 例 和 详细 信息 ， 请 参阅 使 用 结构 (CH 编程 指南 ) o 


有 关 示 例 ， 请 参阅 使 用 结构 (CH 编程 指南 ) o 


请 参阅 

CH 参考 

C# 编程 指南 

CH 关键 字 

默认 值 表 (CR 参考 ) 
HEXER (CH BS) 
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类 型 (Ck 参考 ) 

值 类 型 (CH 参考 ) 

class (C# 参考 ) 

接口 (C# 参考 ) 

类 和 结构 (CH 编程 指南 ) 


struct (C£ 参考 ) 622 


uint (C# 2) 


uint 关键 字 表 示 一 种 整 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 
类 型 范围 大 小 .NET Framework 类 型 


uint ”0 到 4,294,967,295 无 符号 32 位 整数 System.UInt32 


注意 uint 类 型 与 CLS 不 兼容 。 应 尽 可 能 使 用 int。 


文本 


可 如 下 例 所 示 声 明 并 初始 化 uint 类 型 的 变量 : 
uint myUint = 4294967290; 


如 果 整 数 没有 后 级 ， 则 其 类 型 为 以 下 类 型 中 可 表示 其 值 的 第 一 个 类 
型 : int、uint、long、ulong。 在 此 例 中 ， 它 是 uint : 


uint uInti = 123; 
还 可 以 像 下 面 这 样 使 用 后 级 U 或 U : 


uint uInt2 = 123U; 


当 使 用 后 级 U 或 u 时 ， 将 根据 文本 的 数值 来 确定 文本 的 类 型 是 uint 还 是 ulong. 
例如 : 


Console.WriteLine(44U.GetType()); 
Console.WriteLine(323442434344U.GetType()); 


此 代码 先后 显示 System.UInt32 和 System.Ulnt64 (它们 分 别 是 uint 和 ulong 的 
基础 类 型 ) ， 因 为 第 二 个 文本 太 大 ， 无 法 用 uint 类 型 来 存储 。 


转换 


存在 从 uint 到 long, ulong, float, double 或 decimal 的 预定 义 隐 式 转换 。 例 如 : 


float myFloat - 4294967290; // OK: implicit conversion to float 
了 加 本 EN 





存在 从 byte, ushort & char 到 uint 的 预定 义 隐 式 转换 。 否 则 必须 使 用 显 式 转换 。 
例如 ， 如 果 不 进行 强制 转换 ， 下 面 的 赋值 语句 将 产生 编译 错误 : 


long aLong = 22; 


// Error -- no implicit conversion from long: 
uint uInt1 = aLong; 
// OK -- explicit conversion: 


uint uInt2 - (uint)aLong; 


还 请 注意 ， 不 存在 从 浮 点 型 到 uint 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转 
换 ， 否 则 以 下 语句 将 生成 一 个 编译 器 错误 : 


// Error -- no implicit conversion from double: 
uint x = 3.0; 
// OK -- explicit conversion: 


uint y - (uint)3.0; 


有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 
有 关 隐 式 数值 转换 规则 的 更 多 信息 ， 请 参见 隆 式 数 值 转换 表 (C# 参考 ) 。 


CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

UInt32 

CH 参考 

C# 编程 指南 

CH 关键 字 

整 型 表 (CH BB) 
HEXER (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 
显 式 数 值 转换 表 (CHA) 


ulong (C£ 2) 


ulong 关键 字 表 示 一 种 整 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 


类 型 范围 Xu .NET iid 
0 到 无 符号 64 位 
ulong 16 446,744,073,709,551,615 ”整数 eee 


文本 


可 如 下 例 所 示 声 明 并 初始 化 ulong 类 型 的 变量 : 


ulong uLong = 9223372036854775808; 


如 果 整 数 没有 后 级 ， 则 其 类 型 为 以 下 类 型 中 可 表示 其 值 的 第 一 个 类 
型 :int、uint、long、ulong。 在 上 面 的 示例 中 ， 它 是 ulong 类 型 。 


还 可 根据 以 下 规则 使 用 后 级 指定 文字 类 型 : 


e 如 果 使 用 上 或 1， 那么 根据 整数 的 大 小 ， 可 以 判断 出 其 类 型 为 long 还 是 
ulong., 


8 注意 
注意 也 可 用 小 写字 母 咎 作 后 级 。 但 是 ， 因 为 字母 站 容易 与 数字 "1" 混淆， 会 生成 


编译 器 警告 。 为 清楚 起 见 ， 请 使 用 “L”。 


e 如 果 使 用 U 或 u， 那 么 根据 整数 的 大 小 ， 可 以 判断 出 其 类 型 为 uint 还 是 
ulong., 


e 如 果 使 用 UL, ul, Ul uL, LU, lu, Lu 或 IU， 则 整数 的 类 型 为 ulong. 
例如 ， 以 下 三 个 语句 的 输出 将 为 系统 类 型 Ulnt64， 此 类 型 对 应 于 别名 ulong : 
Console.WriteLine(9223372036854775808L .GetType( )); 


Console.WriteLine(123UL.GetType()); 
Console.WriteLine((123UL + 456).GetType( )); 


此 后 绥 常 用 于 调用 重 载 方法 。 以 下 面 使 用 ulong 和 int 参数 的 重 载 方 法 为 例 : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(ulong 1) {} 


在 ulong 参数 后 加 上 后 级 可 保证 调用 正确 的 类 型 ， 例 如 


SampleMethod(5); // Calling the method with the int parameter 
SampleMethod(5UL); // Calling the method with the ulong parameter 


‘ | 





转换 


存在 从 ulong 到 float, double 或 decimal 的 预定 义 隐 式 转换 。 
不 存在 从 ulong 到 任何 整 型 的 隐 式 转换 。 例 如 ， 不 使 用 显 式 类 型 转换 时 ， 下 列 语句 
将 产 生 编 译 错 jk 


long longi - 8UL; // Error: no implicit conversion from ulong 


存在 从 byte, ushort, uint 或 char 到 ulong 的 预定 义 隐 式 转 换 。 


同样 ， 不 存在 从 浮 点 型 到 ulong 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 转换 ， 
否则 以 下 语句 将 生成 一 个 编译 器 错误 : 


// Error -- no implicit conversion from double: 
ulong x = 3.0; 
// OK -- explicit conversion: 


ulong y = (ulong)3.0; 


有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 
有 关 隐 式 数值 转换 规则 的 更 多 信息 ， 请 参见 隐 式 数值 转换 表 (CHESS), 


n zi 
C# j2 5 #3 
有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 


Ulnt64 
CH 参考 
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CH 编程 指南 

C# 关键 字 

整 型 表 (CH 参考 ) 

内 置 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CH 参考 ) 
显 式 数 值 转换 表 (CES) 


ulong (C£ 参考 ) 627 


ushort (C# 参考 ) 


ushort 关键 字 表 示 整 数 数据 类 型 ， 该 类 型 根据 下 表 显 示 的 大 小 和 范围 存储 值 。 
类 型 范围 大 小 .NET Framework 类 型 
ushort ”0 到 65,535 无 符号 16 位 整数 System.UInt16 


文本 


可 如 下 例 所 示 声 明 并 初始 化 ushort 类 型 的 变量 : 


ushort myShort = 65535; 


在 以 上 声明 中 ， 整 数 65535 M int 隐 式 转换 为 ushort。 如 果 整 数 超出 了 ushort 的 
范围 ， 将 产生 编译 错误 。 

必须 使 用 强制 转换 。 以 下 面 使 用 ushort 和 int 参数 的 重 载 方 法 为 
9l : 


public static void SampleMethod(int i) {} 
public static void SampleMethod(ushort s) {} 


使 用 ushort 强制 转换 可 保证 调用 正确 的 类 型 ， 例 如 : 


// Calls the method with the int parameter: 
SampleMethod(5); 

// Calls the method with the ushort parameter: 
SampleMethod((ushort)5); 


转换 


存在 从 ushort 到 int, uint, long, ulong, float, double 或 decimal 的 预定 义 隐 式 
转换 。 


存在 从 byte 或 char 到 ushort 的 预定 义 隐 式 转换 。 其 他 情况 下 必须 使 用 显 式 转 
换 。 例 如 ， 请 看 以 下 两 个 ushort ZÆ x Fy : 


ushort x = 5, y = 12; 


以 下 赋值 语句 将 产生 一 个 编译 错误 ， 原 因 是 赋值 运算 符 右 侧 的 算术 表达 式 在 默认 情 
况 下 的 计算 结果 为 int, 


ushort z = X + y; // Error: conversion from int to ushort 


若 要 解决 此 问题 ， 请 使 用 强制 转换 : 


ushort z = (ushort)(x + y); // OK: explicit conversion 


但 是 ， 在 目标 变量 具有 相同 或 更 大 的 存储 大 小 时 ， 使 用 下 列 语句 是 可 能 的 : 


int m = X + y; 
long Nn = x + y; 


还 请 注意 ， 不 存在 从 浮 点 型 到 ushort 类 型 的 隐 式 转换 。 例 如 ， 除 非 使 用 显 式 强制 
转换 ， BMI LA Biz 吾 句 将 生成 一 个 编译 器 错误 : 


// Error -- no implicit conversion from double: 
ushort x = 3.0; 
// OK -- explicit conversion: 


ushort y - (ushort)3.0; 


有 关 兼 用 浮 点 型 和 整 型 的 算术 表达 式 的 信息 ， 请 参见 float 和 double, 

有 关 隐 式 数值 转换 规则 的 更 多 信息 ， 请 参见 隐 式 数值 转换 表 (C# 参考 ) 。 

CH SSE 

有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 

UInt16 


C# 参考 
C# 编程 指南 
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C# 关键 字 

整 型 表 (CH 参考 ) 
内 置 类 型 表 (CH 参考 ) 

隐 式 数值 转换 表 (CES) 
显 陈 数值 转换 表 (CES) 


ushort (C£ 27) 630 


引用 类 型 (C 参考 ) 


CH 中 有 两 种 类 型 : 引用 类 型 和 值 类 型 。 引 用 类 型 的 变量 存储 对 其 数据 (对象) 的 
引用 ， 而 值 类 型 的 变量 直接 包含 其 数据 。 对 于 引用 类 型 ， 两 种 变量 可 引用 同一 对 
象 ; 因此 ， 对 一 个 变量 执行 的 操作 会 影响 另 一 个 变量 所 引用 的 对 象 。 对 于 值 类 型 ， 
每 个 变量 都 具有 其 自己 的 数据 副本 ， 对 一 个 变量 执行 的 操作 不 会 影响 另 一 个 变量 
(ref 和 out 参数 变量 除外 ， 请 参见 ref (CH 参考 ) 和 out 参数 修饰 符 (CR E 
考 ) ) 。 
下 列 关 键 字 用 于 声明 引用 类 型 : 

e Class 

e interface 

e delegate 
C4 也 提供 了 下 列 内 置 引用 类 型 : 

e dynamic 

e object 


e String 


请 参阅 

C# 参考 

C# 编程 指南 
C# 关键 字 

类 型 (CH 参考 ) 


值 类 型 (CH 参考 ) 


class (C# 2€) 
类 是 使 用 关键 字 class 声明 的 ， 如 下 面 的 示例 所 示 : 


class TestClass 


// Methods, properties, fields, events, delegates 
// and nested classes go here. 


备注 


唯一 继承 在 c# 中 允许 的 。 也 就 是 说 ， 类 只 能 从 一 个 基 类 继承 实现 。 但 是 ， 一 个 类 
可 以 实现 一 个 以 上 的 接口 。 下 表 给 出 了 类 继承 和 接口 实现 的 一 些 示 例 : 


Inheritance 示例 
无 class ClassA { } 
Single class DerivedClass: BaseClass ( } 
无 ， 实 现 两 个 接口 classtImplCiass ErEaACeT leace2 人 办 
单一 ， 实 现 一 个 接 


口 class ImplDerivedClass: BaseClass, IFacei { } 


在 其 他 选 件 类 中 可 以 直接 在 命名 空间 内 声明 的 选 件 类 ， 未 徐 套 ， 可 以 是 公开 或 内 
部 。 默 认 情 况 下 选 件 类 是 internal. 


类 成 员 ， 包 括 赃 套 选 件 类 ， 可 以 是 AH, protected internal、 保 护 、 内 部 或 = 
用 。 默 认 情 况 下 成 员 是 专用 。 


有 关 更 多 信息 ， 请 参见 访问 修饰 符 (CH 编程 指南 ) o 
可 以 声明 具有 类 型 参数 的 泛 型 选 件 类 。 有 关 更 多 信息 ， 请 参见 泛 型 选 件 类 。 
一 个 类 可 包含 下 列 成 员 的 声明 : 

e VS AA 

e Jr ERR 

e 常量 

e 字段 

e 方法 


e 接口 
e 结构 


TARANA AAE RAYE. HSA AIA. API BA f MO 3c lib xt 
象 及 如 何 打印 实例 数据 。 在 此 例 中 声明 了 两 个 类 ， 一 个 是 Child 类 ， 它 包含 两 个 私 
有 字段 (name 和 age) 和 两 个 公共 方法 。 第 二 个 类 StringTest 用 来 包含 Main。 


class Child 


{ 
private int age; 
private string name; 
// Default constructor: 
public Child() 
{ 
name = "N/A"; 
j 
// Constructor: 
public Child(string name, int age) 
{ 
this.name = name; 
this.age = age; 
} 
// Printing method: 
public void PrintChild() 
{ 
Console.writeLine("{0}, {1} years old.", name, age); 
} 
} 
class StringTest 
{ 
static void Main() 
{ 
// Create objects by using the new operator: 
Child child1 = new Child("Craig", 11); 
Child child2 - new Child("Sally", 10); 
// Create an object using the default constructor: 
Child child3 = new Child(); 
// Display results: 
Console.Write("Child #1: "); 
child1.PrintChild(); 
Console.Write("Child #2: "); 
child2.PrintChild(); 
Console.Write("Child £3: "); 
child3.PrintChild(); 
} 
} 
/* Output: 


Child #1: Craig, 11 years old. 
Child #2: Sally, 10 years old. 
Child #3: N/A, © years old. 

ey 


注释 


注意 : 在 上 例 中 ， 私 有 字段 (name 和 age) 只 能 通过 Child 类 的 公共 方法 访问 。 
例如 ， 不 能 在 Main 方法 中 使 用 如 下 语句 打印 Child HAA : 


Console.Write(child1.name) ; // Error 


只 有 当 Child 是 Main 的 成 员 时 ， 才 能 从 Main 访问 该 类 的 私有 成 员 。 


类 型 声明 在 选 件 类 中 ， 不 使 用 访问 修饰 符 默认 为 private， 因 此 ， 在 此 示例 中 的 数 
据 成 员 会 private， 如 果 移 除了 关键 字 。 


最 后 要 注意 的 是 ， 上 默认 情况 下 ， 对 于 使 用 默认 构造 画 数 (child3) 创建 的 对 象 ，age 
字段 初始 化 为 需 。 


C4 2 BASE 

有 关 详 细 信 息 ， 请 参 阅 CË jz B. 该 语 言 规范 JE 是 CH 语法 和 用 法 的 权威 资 料 。 
$$ 
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CH 关键 字 
引用 类 型 (Cg 参考 ) 


委托 (CH 参考 ) 
委托 类 型 的 声明 与 方法 签名 相似 ， 有 一 个 返回 值 和 任意 数目 任意 关 型 的 参数 : 


public delegate void TestDelegate(string message); 
public delegate int TestDelegate(MyType m, long num); 


delegate 是 一 种 可 用 于 封装 命名 或 匿名 方法 的 引用 类 型 。 委 托 类 似 于 C++ 中 的 函 
数 指针 ; 但 是 ， 委 托 是 类 型 安全 和 可 靠 的 。 有 关 委 托 的 应 用 ， 请 参见 委托 和 泛 型 委 
托 。 


备注 
委托 是 事件 的 基础 。 


通过 将 委托 与 命名 方法 或 匿名 方法 关联 ， 可 以 实例 化 委托 。 有 关 更 多 信息 ， 请 参见 
命名 方法 和 匿名 方法 。 


必须 使 用 具有 兼容 返回 类 型 和 输入 参数 的 方法 或 lambda 表达 式 实例 化 委托 。 有 关 
方法 签名 中 人 允许 的 差异 程度 的 更 多 信息 ， 请 参见 委托 中 的 变 体 (C#4 Visual 
Basic) 。 为 了 与 匿名 方法 一 起 使 用 ， 委 托 和 与 之 关联 的 代码 必须 一 起 声明 。 本 节 
讨论 这 两 种 实例 化 委托 的 方法 。 


// Declare delegate -- defines required signature: 
delegate double MathAction(double num); 


class DelegateTest 


{ 

// Regular method that matches signature: 

static double Double(double input) 

{ 
return input * 2; 

j 

static void Main() 

{ 
// Instantiate delegate with named method: 
MathAction ma = Double; 
// Invoke delegate ma: 
double multByTwo = ma(4.5); 
Console.WriteLine("multByTwo: {0}", multByTwo); 
// Instantiate delegate with anonymous method: 
MathAction ma2 = delegate(double input) 
{ 

return input * input; 

3 
double square - ma2(5); 
Console.WriteLine("square: (0)", square); 
// Instantiate delegate with lambda expression 
MathAction ma3 = s => s * s * s; 
double cube = ma3(4.375); 
Console.WriteLine("cube: {0}", cube); 

} 

// Output: 

// multByTwo: 9 

// square: 25 

// cube: 83.740234375 

} 
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dynamic (C£ 2) 


在 通过 dynamic 类 型 实现 的 操作 中 ， 该 类 型 的 作用 是 绕 过 编译 时 类 型 检查 ， 改 为 
在 运行 时 解析 这 些 操作 。 dynamic 类 型 简化 了 对 COMAPI (例如 Office 
Automation API) 、 动 态 API (例如 IronPython 库 ) 和 HTML 文档 对 象 模型 
(DOM) 的 访问 。 


在 大 多 数 情况 下 ，dynamic 类 型 与 object 类 型 的 行为 是 一 样 的 。 但 是 ， 不 会 用 编 
译 器 对 包含 dynamic 类 型 表达 式 的 操作 进行 解析 或 类 型 检查 。 编 译 器 将 有 关 该 操 
作 信 息 打包 在 一 起 ， 并 且 该 信息 以 后 用 于 计算 运行 时 操作 。 在 此 过 程 中 ， 类 型 
dynamic 的 变量 会 编译 到 类 型 object 的 变量 中 。 因 此 ， 类 型 dynamic 只 在 编译 
时 存在 ， 在 运行 时 则 不 存在 。 


以 下 示例 将 类 型 为 dynamic 的 变量 与 类 型 为 object 的 变量 对 比 。 若 要 在 编译 时 验 
证 每 个 变量 的 类 型 ， 请 将 鼠标 指针 放 在 WriteLine 语句 中 的 dyn 3 obj 上 。 
IntelliSense 显示 了 dyn 的 dynamic" 和 obj 的 “object”。 


class Program 


( 


static void Main(string[] args) 


{ 
dynamic dyn = 1; 
object obj = 1; 


// Rest the mouse pointer over dyn and obj to see their 
// types at compile time. 
System.Console.WriteLine(dyn.GetType( 


)); 
System.Console.WriteLine(obj.GetType()); 


WriteLine 语句 显示 dyn 和 obj 的 运行 时 类 型 。 此 时 ， 两 者 具有 相同 的 整数 类 型 。 
将 生成 以 下 输出 : 


System.Int32 
System.Int32 
若 要 查看 dyn 和 obj 之 间 的 差异 ， 请 在 前 面 示例 的 声明 和 WriteLine 语句 之 间 添 加 
下 列 两 行 之 间 。 


dyn 
obj 


dyn + 3; 
obj + 3; 


为 党 试 添加 表达 式 obj + 3 中 的 整数 和 对 象 报 告 编译 器 错误 。 但 是 ， 不 会 报告 dyn + 
3 错误 。 编 译 时 不 会 检查 包含 dyn 的 表达 式 ， 原 因 是 dyn 的 类 型 为 dynamic. 


EPX 


dynamic 关键 字 可 以 直接 出 现 或 作为 构造 类 型 的 组 件 在 下 列 情况 中 出 现 : 


。 在 声明 中 ， 作 为 属性 、 字 段 、 索 引 器 、 参 数 、 返 回 值 或 类 型 约束 的 类 型 。 下 面 
的 类 定义 在 几 个 不 同 的 声明 中 使 用 dynamic. 


class ExampleClass 


1 
// A dynamic field. 


static dynamic field; 


// A dynamic property. 
dynamic prop { get; set; } 


// A dynamic return type and a dynamic parameter type. 
public dynamic exampleMethod(dynamic d) 
{ 


// A dynamic local variable. 
dynamic local = "Local variable"; 
int two = 2; 


if (d is int) 
{ 

} 

else 


{ 
} 


return local; 


return two; 


e 在 显 式 类 型 转换 中 ， 作 为 转换 的 目标 类 型 。 


static void convertToDynamic() 
{ 
dynamic d; 
int i = 20; 
d = (dynamic)i; 
Console.WriteLine(d); 


string s - "Example string."; 
d = (dynamic)s; 
Console.WriteLine(d); 


DateTime dt - DateTime.Today; 
d - (dynamic)dt; 
Console.WriteLine(d); 


} 

// Results: 

// 20 

// Example string. 

// 2/17/2009 9:12:00 AM 


e 在 以 类 型 充当 值 Mis 运算 符 或 as 运算 符 右 侧 ) 或 者 作为 typeof 的 参数 成 


为 构造 类 型 的 一 部 分 的 任何 上 下 文中 。 例 如 ， 可 以 在 下 列表 达 式 中 使 用 
dynamic。 


int i = 8; 

dynamic d; 

// With the is operator. 

// The dynamic type behaves like object. The following 


// expression returns true unless someVar has the value null. 


if (someVar is dynamic) { } 


// With the as operator. 
d = i as dynamic; 


// With typeof, as part of a constructed type. 
Console.WriteLine(typeof(List&lt;dynamic&gt; )); 


// The following statement causes a compiler error. 
//Console.WriteLine(typeof (dynamic) ); 


BJE 
下 面 的 示例 以 多 个 声明 使 用 dynamic。 Main 也 用 运行 时 类 型 检查 对 比 编译 时 类 型 


检查 。 


using System; 


namespace DynamicExamples 


( 


class Program 


{ 
static void Main(string[] args) 
{ 
ExampleClass ec = new ExampleClass(); 
Console.WriteLine(ec.exampleMethod(10) ); 
Console.WriteLine(ec.exampleMethod("value") ); 
// The following line causes a compiler error because 上 4 
// takes only one argument. 
//Console.WriteLine(ec.exampleMethod(10, 4)); 
dynamic dynamic ec = new ExampleClass(); 
Console.WriteLine(dynamic_ec.exampleMethod(10) ); 
// Because dynamic ec is dynamic, the following call tc 
// with two arguments does not produce an error at com 
// However, itdoes cause a run-time error. 
//Console.WriteLine(dynamic_ec.exampleMethod(10, 4)); 
} 
} 
class ExampleClass 
{ 
static dynamic field; 
dynamic prop { get; set; } 
public dynamic exampleMethod(dynamic d) 
{ 
dynamic local = "Local variable"; 
int two = 2; 
if (d is int) 
{ 
return local; 
} 
else 
{ 
return two; 
} 
} 
} 
} 
// Results: 
// Local variable 
// 2 


// Local variable 





有 关 更 多 信息 和 示例 ， 请 参见 使 用 类 型 dynamic (C£ 编程 指南 ) 。 
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接口 (CH 参考 ) 


接口 只 包含 方法 、 属 性 、 事 件 或 索引 器 的 签名 。 实现 接口 的 类 或 结构 必须 实现 接口 
定义 中 指定 的 接口 成 员 。 在 下 面 的 示例 ， 类 ImplementationClass 必须 实现 一 个 不 
具有 参数 并 返回 void 的 名 为 SampleMethod 的 方法 。 


有 关 更 多 信息 和 示例 ， 请 参见 接口 (CH 编程 指南 ) 。 
示例 


interface ISampleInterface 


void SampleMethod(); 


} 
class ImplementationClass : ISampleInterface 
{ 
// Explicit interface member implementation: 
void ISampleInterface.SampleMethod() 
// Method implementation. 
} 
static void Main() 
{ 
// Declare an interface instance. 
ISampleInterface obj = new ImplementationClass(); 
// Call the member. 
obj .SampleMethod(); 
} 
} 


接口 可 以 是 命名 空间 或 类 的 成 员 ， 并 且 可 以 包含 下 列 成 员 的 签名 : 
e 方法 

。 属性 

e ROLAT 

。 事 件 

一 个 接口 可 从 一 个 或 多 个 基 接 口 继承 。 

当 基 类 型 列表 包含 基 类 和 接口 时 ， 基 类 必须 是 列表 中 的 第 一 项 。 


实现 接口 的 类 可 以 显 式 实现 该 接口 的 成 员 。 显 式 实现 的 成 员 不 能 通过 类 实例 访问 ， 
而 只 能 通过 接口 实例 访问 。 


ee 
ES o 


示例 


下 面 的 示例 演示 了 接口 实现 。 在 此 示例 中 ， 接 口 包含 属 性 声明 ， 类 包含 实现 。 实 
现 IPoint 的 类 的 任何 实例 都 具有 整数 属性 x 和 yo 


interface IPoint 
{ 
// Property signatures: 
int x 
{ 
get; 
set; 


} 


int y 
{ 
get; 
set; 
} 
} 


class Point : IPoint 
{ 
// Fields: 
private int _x; 
private int _y; 


// Constructor: 

public Point(int x, int y) 
{ 

X; 

y; 


=) 


} 


// Property implementation: 
public int x 


1 
get 


( 


return x; 


set 


CH i 


public int y 
{ 
get 
{ 
return _y; 
} 
set 


{ 


} 
} 
} 


y = value 


{ 


class MainClass 
{ 


} 


static void PrintPoint(IPoint p) 


Console.WriteLine("x={0}, y={1}" 
static void Main() 
{ 


Point p 


X, p.y); 
new Point(2, 3); 
Console.Write("My Point: "); 
PrintPoint(p); 
} 
// Output: My Point: x=2, y=3 
h = i 
$max 


参阅 
C# 参考 
C# 编程 指南 
CHART 
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object (C£ 2) 


object 类 型 在 .NET Framework 中 是 Object 的 别名 。 在 CH 的 统一 类 型 系统 中 ， 
所 有 类 型 (预定 义 类 型 、 用 户 定义 类 型 、 引 用 类 型 和 值 类 型 ) 都 是 直接 或 间接 从 
Object 继承 的 。 可 以 将 任何 类 型 的 值 赋 给 object 类 型 的 变量 。 将 值 类 型 的 变量 转 
换 为 对 象 的 过 程 称 为 “ 装 箱 ”。 .将 对 象 类 型 的 变量 转换 为 值 类 型 的 过 程 称 为 "取消 装 
TH. 有 关 更 多 信息 ， 请 参见 装 箱 和 取消 装 箱 。 


示例 


下 面 的 示例 演示 了 object 类 型 的 变量 如 何 接受 任何 数据 类 型 的 值 ， 以 及 object X 
型 的 变量 如 何在 .NET Framework 中 使 用 Object 的 方法 。 


class ObjectTest 


public int i - 10; 


} 
class MainClass2 
1 
static void Main() 
{ 
object a; 
a= 1; // an example of boxing 
Console.WriteLine(a); 
Console.WriteLine(a.GetType()); 
Console.WriteLine(a.ToString()); 
a = new ObjectTest(); 
ObjectTest classRef; 
classRef - (ObjectTest)a; 
Console.WriteLine(classRef.i); 
} 
} 
/* Output 
1 
System. Int32 
1 
* 10 
SA 
n ze 
CZ BAS 
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string (C# 2) 


string 类 型 表示 一 个 字符 序列 (FARE Unicode 字符 ) 。 string = .NET 
Framework 中 String 的 别名 。 


RS string 是 引用 类 型 ， 但 定义 相等 运算 符 (== 和 I=) 是 为 了 比较 string 对 象 
(而 不 是 引用 ) 的 值 。 这 使 得 对 字符 串 相等 性 的 测试 更 为 直观 。 例 如 : 


string a = "hello"; 
string b = "h"; 
// Append to contents of 'b' 
b += "ello"; 
Console.WriteLine(a == b); 
Console.WriteLine((object)a == (object)b); 


这 将 先 显 示 “True”， 然 后 显示 "False"， 因 为 字符 串 的 内 容 是 相同 的 ， 但 是 a 和 b 引 
用 的 不 是 同一 个 字符 串 实例 。 


。 运算 符 用 于 连接 字符 串 : 
string a = "good " + "morning"; 


这 将 创建 一 个 包含 “good morning” 的 字符 串 对 象 。 


字符 串 是 不 可 变 的 ， 即 : 字符 串 对 象 在 创建 后 ， 尽 管 从 语法 上 看 您 似乎 可 以 更 改 其 
内 容 ， 但 事实 上 并 不 可 行 。 例 如 ， 编 写 此 代码 时 ， 编 译 器 实际 上 会 创建 一 个 新 字符 
串 对 象 来 保存 新 的 字符 序列 ， 且 新 对 象 将 赋 给 b。 然 后 字符 串 “h" 将 适宜 于 垃圾 回 


o 


string b = "h"; 
b += "ello"; 


[] 运算 符 可 以 用 于 对 string 的 各 个 字符 的 只 读 访 问 。 


string str = "test"; 
char x = str[2]; // x = 's'; 


字符 串 为 string 类 型 并 可 写成 两 种 形式 ， 即 用 引号 引起 来 和 用 @ 引起 来 。 用 引号 
引起 来 的 字符 串 括 在 双 引 号 (") A: 


"good morning" // a string literal 


字符 串 文 本 可 包含 任何 字符 。 包 括 转 义 序列 。 下 面 的 示例 使 用 转 义 序列 \ 来 表示 反 
MAL, ($H \u0066 来 表示 字母 f， 使 用 \n 来 表示 换行 符 。 


string a = "\\\u0066\n"; 
Console.WriteLine(a); 
8 注意 


转 义 码 \uUddqd (其 中 dddd 是 一 个 四 位 数 ) 表示 Unicode 字符 Utdddd, HES 
还 识别 8 位 Unicode 转 义 码 : \Udddddddd. 


原 义 字符 串 以 @ 开头 并 且 也 用 双 引 号 引起 来 。 例 如 : 


@"good morning" // a string literal 


原 义 字符 串 的 优势 在 于 不 处 理 转 义 序 列 ， 因 此 很 容易 导入 ， 例 如 完全 限定 的 文件 名 
就 是 原 义 字符 串 : 


@"c:\Docs\Source\a.txt" // rather than "c:\\Docs\\Source\\a. txt" 
OOOO ëO 
若 要 在 一 个 用 @ 引起 来 的 字符 串 中 包括 一 个 双 引 号 ， 请 使 用 两 对 双 引 号 : 


Q"""Ahoy!"" cried the captain." // "Ahoy!" cried the captain. 


@ 符号 的 另 一 种 用 法 是 使 用 作为 C# 关键 字 的 被 引用 的 (/reference) 标识 符 。 
EX C# 中 字符 串 的 更 多 信息 ， 请 参见 字符 串 (CH 编程 指南 ) o 


class SimpleStringTest 


{ 
static void Main() 
{ 
string a = "\u0068ello "; 
string b = "world"; 
Console.WriteLine( a + b ); 
Console.WriteLine( a + b == "Hello World" ); // == performs : 
j 
} 
/* Output: 
hello world 
False 
SA 





\ 工 = < 
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Ath (CR 和 Visual Basic 8l FH) 


用 于 构造 字符 串 。 内 揪 字 符 串 表达 式 类 似 于 包含 表达 式 的 模板 字符 串 。 内 插 字 符 串 
表达 式 通过 将 包含 的 表达 式 蔡 换 为 表达 式 结 果 的 ToString 表示 形式 来 创建 字符 串 。 
l 复合 格式 设置 相 比 ， 内 插 字 符 串 在 参数 方面 更 易于 理解 。 下 面 是 内 揪 字 符 串 的 示 
9l : 


Console.WriteLine($"Name = {name}, hours = {hours:hh}") 


内 插 字 符 串 的 结构 如 下 所 示 : 


$ " «text» ( «interpolation-expression» «optional-comma-field-widtl 
| s z 
可 以 在 可 使 用 字符 串 的 任何 位 置 使 用 内 插 字 符 串 。 当 运行 程序 会 执行 带 内 插 字 符 串 


的 代码 时 ， 此 代码 会 通过 计算 内 插 表 达 式 来 计算 新 的 字符 串 。 每 次 执行 带 内 插 字符 
串 的 代码 时 ， 都 会 发 生 此 计算 。 


若 要 在 内 插 字符 串 中 包含 大 括号 CCOmÁCY) ， 请 使 用 两 个 大 括号 ， 即 ”。 请 参阅 “ 隐 
式 转换 "部 分 以 获取 详细 信息 。 





隐 式 转换 
内 插 字符 串 中 的 隐 式 类 型 转换 如 下 : 


var s = $"hello, {name}" 
System.IFormattable s = $"Hello, {name}" 
System.FormattableString = $"Hello, {name}" 


第 一 个 示例 生成 一 个 string 值 ， 其 中 计算 了 所 有 字符 串 内 插值 。 此 为 最 终结 果 ， 并 
具有 string 类 型 。 出 现 的 所 有 双 大 括号 (7) 都 转换 为 单 大 括号 。 


第 二 个 示例 生成 一 个 IFormattable 变量 ， 此 变量 允许 使 用 固定 上 下 文 转 换 字符 串 。 
要 使 数值 和 数据 格式 在 不 同 放言 中 正确 先 误 此 操作 非常 有 用 。 出 现 的 所 有 双 大 括 
5 CC") 仍 保 留 为 双 大 括号 ， 直 至 将 字符 串 设置 为 ToString 格式 。 包 含 的 所 有 内 插 
表达 式 都 转换 为 {0}、{1} SS. 


s.ToString(null, System.Globalization.CultureInfo.InvariantCulture: 


sj mu 


| 








第 三 个 示例 生成 一 个 下 System.FormattableString， 它 允许 检查 由 插值 计算 产生 的 
对 象 。 例 如 ， 检 查 对 象 及 其 呈现 为 字符 串 的 方式 可 能 有 助 于 你 在 生成 查询 时 防止 注 
入 攻击 。 借 助 FormattableString， 只 需 简单 操作 即 可 生成 InvariantCulture 和 
CurrentCulture 字符 串 结果 。 在 设置 格式 之 前 ， 出 现在 所 有 双 大 括号 〈”) RBZ 
双 括号 。 包 含 的 所 有 内 插 表 达 式 都 转换 为 {0}、{1} 等 等 。 


示例 


$"Name = {name}, hours = {hours:hh}" 

var s = $"hello, {name}" 

System.IFormattable s = $"Hello, {name}" 

System.FormattableString = $"Hello, {name}" 

$"{person.Name, 20} is {person.Age:D3} year {(p.Age == 1 ? "" : "s' 


Eo 了 


无 需 在 包含 的 内 插 表 达 式 中 引用 引号 字符 ， 因 为 内 插 字 符 串 表达 式 以 $ 开始 ， 而 且 
编译 器 会 将 包含 的 内 插 表 达 式 扫 擂 为 平衡 文本 ， 直 至 它 发 现 逗 号、 冒号 或 右 大 括 
号 。 出 于 相同 原因 ， 最 后 一 个 示例 使 用 括号 来 使 条 件 表 达 式 (p.Age == 1?" : "s") 
包含 在 其 格式 规范 不 以 冒号 开头 的 内 插 表 达 式 中 。 在 包含 的 内 插 表 达 式 外 部 (但 仍 
在 内 插 字符 串 表达 式 之 中 ) ， 可 按 通常 方式 转 义 引号 字符 。 





语法 


expression: 
interpolated-string-expression 


interpolated-string-expression: 
interpolated-string-start interpolations interpolated-string-er 


interpolations: 
single-interpolation 
single-interpolation interpolated-string-mid interpolations 


single-interpolation: 
interpolation-start 
interpolation-start : regular-string-literal 


interpolation-start: 
expression 
expression , expression 
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有 关 详 细 信 息 ， 请 参阅 C# AEG. ABADE C# 语法 和 用 法 的 权威 资料 。 


有 关 详 细 信 息 ， 请 参阅 Visual Basic 语言 参考 。 


请 参阅 
System.IFormattable 
TSystem.FormattableString 
C# 参考 

CH 编程 指南 

Visual Basic 语言 参考 


Visual Basic 编程 指南 


内 插 字 符 串 (CX 和 Visual Basic 引用 ) 655 


void (C4 参考 ) 


当 使 用 ， 因 为 方法 的 ，void 返回 类 型 指定 方法 不 返回 值 。 
void 在 不 允许 参数 列表 方法 。 采 用 以 下 形式 声明 一 个 无 参数 的 、 不 返回 值 的 方法 : 


public void SampleMethod() 


// Body of the method. 


也 可 在 不 安全 上 下 文中 使 用 void 将 指针 声明 为 未 知 类 型 。 有 关 更 多 信息 ， 请 参见 
指针 类 型 (CH 编程 指南 ) o 


void 是 .NET Framework System.Void 类 型 的 别名 。 


C# iE 

有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

引用 类 型 (CH 参考 ) 

值 类 型 (C# 参考 ) 

方法 (CH 编程 指南 ) 

不 安全 代码 和 指针 (CH 编程 指南 ) 


var (C# 2) 


从 Visual C£ 3.0 开始 ， 在 方法 范围 中 声明 的 变量 可 以 具有 隐 式 类 型 var。 隐 式 类 型 
的 本 地 变量 是 强 类 型 变量 (就 好 像 您 已 经 声明 该 类 型 一 样 ) ， 但 由 编译 器 确定 类 
型 。 下 面 的 两 个 i 声明 在 功能 上 是 等 效 的 : 


var i 
int i 


10; // implicitly typed 
10; //explicitly typed 


有 关 更 多 信息 ， 请 参见 隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) 和 Type Relationships 
in LINQ Query Operations (C£). 


下 面 的 示例 演示 了 两 个 查询 表达 式 。 在 第 一 个 表达 式 中 ， 人 多 许 但 不 需要 使 用 var， 

因为 可 以 将 查询 结果 的 类 型 显 式 声明 为 IEnumerable<string>。 但 是 ， 在 第 二 个 表 
达 式 中 必须 使 用 var， 因 为 结果 是 一 个 匿名 类 型 集合 ， 而 该 类 型 的 名 称 只 有 编译 器 
zen 请 注意 ， 在 第 二 个 示例 中 ，foreach 和 迭代 变量 item 也 必须 转换 为 隐 





// Example Z1: var is optional because 
// the select clause specifies a string 
string[] words = { "apple", "strawberry", "grape", "peach", "banan: 
var wordQuery = from word in words 
where word[0] == 'g' 
select word; 


// Because each element in the sequence is a string, 
// not an anonymous type, var is optional here also. 
foreach (string s in wordQuery) 


Console.WriteLine(s); 


j 


// Example Z2: var is required because 
// the select clause specifies an anonymous type 
var custQuery - from cust in customers 
where cust.City -- "Phoenix" 
select new ( cust.Name, cust.Phone }; 


// var must be used because each item 
// in the sequence is an anonymous type 
foreach (var item in custQuery) 


Console.WriteLine("Name-(0), Phone={1}", item.Name, item.Phone 
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请 参阅 

C# 参考 

C# 编程 指南 

隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) 


var (CH 参考 ) 658 


USER (CH 参考 ) 


以 下 参考 表 概 括 了 C# 的 类 型 : 

内 置 类 型 表 

整 型 

浮 点 型 

默认 值 

值 类 型 

隐 式 数值 转换 

显 式 数值 转换 表 

有 关 格 式 化 数字 类 型 输出 的 信息 ， 请 参见 格式 化 数值 结果 表 。 


请 参阅 

CH 参考 

C# 编程 指南 

引用 类 型 (CH BS) 
值 类 型 (C# 参考 ) 


ABER (Cf 参考 ) 


下 表 显 示 了 内 置 CH 类 型 的 关键 字 ， 这 些 类 型 是 System 命名 空间 中 的 预定 义 类 型 
的 别名 。 


C# 类 型 .NET Framework 类 型 
bool System.Boolean 
byte System.Byte 
sbyte System.SByte 
char System.Char 
decimal System.Decimal 
double System.Double 
float System.Single 
int System.Int32 
uint System.UInt32 
long System.Int64 
ulong System.UInt64 
xt RK System.Object 
short System.Int16 
ushort System.UInt16 
string System.String 


备注 
除了 object 和 string 外 ， 表 中 的 所 有 类 型 均 称 为 简单 类 型 。 
CH 类 型 的 关键 字 及 其 别名 可 以 互 换 。 例 如 ， 可 使 用 下 列 两 种 声明 中 的 一 种 来 声明 
一 个 整数 变量 : 
ant x = 123° 


System.Int32 x - 123; 


若 要 显示 任何 C# 类 型 的 实际 类 型 ， 请 使 用 系统 方法 GetType()。 例 如 ， 下 列 语句 
显示 了 表示 myVariable 类 型 的 系统 别名 : 
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Console.WriteLine(myVariable.GetType()); 
还 可 使 用 typeof 运算 符 。 


请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

值 类 型 〈C# 参考 ) 

默认 值 表 (CH 参考 ) 

设置 数值 结果 表 的 格式 (CH 参考 ) 
dynamic (C# 参考 ) 

类 型 参考 表 (CH 参考 ) 


内 置 类 型 表 (CH 参考 ) 661 


整 型 表 (CH 参考 ) 


下 表 显 示 了 整 型 的 大 小 和 范围 ， 这 些 类 型 构成 了 简单 类 型 的 一 个 子 集 。 


类 型 


sbyte 


byte 


char 


short 


ushort 


int 


uint 


long 


ulong 


如 果 整 数 表示 的 值 超出 了 ulong 的 范围 ， 将 产生 编译 错误 。 


请 参阅 


C# 参考 


N 
In 
H9 


-128 到 127 


0 到 255 


U+0000 到 U+ffff 


-32,768 到 32,767 


0 到 65,535 


-2,147,483,648 到 2,147,483,647 


0 到 4,294,967,295 


-9,223,372,036,854,775,808 到 
9,223,372,036,854,775,807 


0 到 18,446,744,073,709,551,615 


C# 编程 指南 


C# 关键 字 


内 置 类 型 表 (CH 参考 ) 

浮 点 型 表 (C# 参考 ) 

默认 值 表 (CH 参考 ) 

设置 数值 结果 表 的 格式 (C# 参考 ) 


大 小 
有 符号 8 位 整 
数 
无 符号 8 位 整 
数 
16 位 Unicode 
字符 
有 符号 16 位 整 
数 
无 符号 16 位 整 
数 
有 符号 32 位 整 
数 
无 符号 32 位 整 
数 
有 符号 64 位 整 
数 
无 符号 64 位 整 
数 
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类 型 参考 表 (CH 参考 ) 


整 型 表 (CH 参考 ) 663 
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emi (CH 参考 ) 


下 表 显 示 了 浮 点 型 的 精度 和 大 致 范围 。 


float +1.5e-45 到 +3.4e38 7 位 
double +5.0e-324 到 +1.7e308 15 到 16 位 
请 参阅 
CH 参考 


C# 编程 指南 

默认 值 表 (CH 参考 ) 

内 置 类 型 表 (C# 参考 ) 

HER (CH 参考 ) 
设置 数值 结果 表 的 格式 (CH 参考 ) 
类 型 参考 表 (C# 参考 ) 

decimal (C£ 参考 ) 


浮 点 型 表 (CH 参考 ) 


664 


默认 值 表 (CH 参考 ) 


下 表 显 示 了 由 默认 构造 画 数 返回 的 值 类 型 的 默认 值 。 默 认 构 造 男 数 是 通过 new 运 
算 符 来 调用 的 ， 如 下 所 示 : 


int myInt = new int(); 


以 上 语句 同 下 列 语 句 效果 相同 : 


int myInt = 0; 


请 记 住 : 在 CR 中 不 允许 使 用 未 初始 化 的 变量 。 


值 类 型 默认 值 
bool false 

byte 0 

char ^O' 

decimal | 0.0M 

double 0.0D 

enum 表达 式 (E)0 产生 的 值 ， 其 中 E X enum 标识 符 。 
float 0.0F 

int 0 

long OL 

sbyte 0 

short 0 


将 所 有 的 值 类 型 字段 设置 为 默认 值 并 将 所 有 的 引用 类 型 字段 设置 为 


struct null 时 产生 的 值 。 
uint 0 
ulong 0 
ushort 0 


请 参阅 
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CH 参考 

CH 编程 指南 

值 类 型 表 (C# 参考 ) 
值 类 型 (CR 参考 ) 
HEXER (CES) 
类 型 参考 表 (CH 参考 ) 


默认 值 表 (CH 参考 ) 
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类 型 表 (C# 参考 ) 


下 表 按 类 别 列 出 了 CH 的 值 类 型 


值 类 型 
bool 
byte 
char 
decimal 
double 
enum 
float 
int 
long 
sbyte 
short 
struct 
uint 
ulong 


ushort 


请 参阅 
C# 参考 
C# 编程 指南 


默认 值 表 (CH 参考 ) 
值 类 型 (C# 参考 ) 


Boolean 


无 符号 、 数 值 、 整 
无 符号 、 数 值 、 


数值 、 十 进 制 
数值 、 浮 点 
Enumeration 


数值 、 浮 点 


有 符号 、 数 值 、 
有 符号 、 数 值 、 
有 符号 、 数 值 、 
有 符号 、 数 值 、 
用 户 定义 的 结构 
无 符号 、 数 值 、 
无 符号 、 数 值 、 
无 符号 、 数 值 、 


设置 数值 结果 表 的 格式 (CH 参考 ) 
类 型 参考 表 (CH 参考 ) 


整数 
整数 
整数 
整数 


整数 
整数 
整数 


M 或 m 
D z d 


F 或 f 


L 或 | 


U 3 u 
UL 或 ul 


隐 式 数值 转换 表 (CH SA) 


下 表 显 示 了 预定 义 的 隐 式 数值 转换 。 隐 式 转 换 可 能 在 多 种 情形 下 发 生 ， 包 括 调用 方 
法 时 和 在 赋值 语句 中 。 


源 目标 
sbyte ^ short, int, long, float, double 或 decimal 


short, ushort, int, uint, long. ulong, float, double 或 


us decimal 


short int. long, float, double 或 decimal 


ushort int, uint, long. ulong, float, double 或 decimal 


int long. float, double 或 decimal 

uint long. ulong, float, double 或 decimal 

long float, double 或 decimal 

char ushort, int, uint, long, ulong, float, double 或 decimal 
float double 


ulong float, double 或 decimal 


备注 


e 可 能 从 转换 中 丢失 精度 ， 但 不 是 模 int， uint, long， 或 ulong 到 float 和 long 
或 ulong 到 double。 


e 不 存在 到 char 类 型 的 隐 式 转换 。 
。 不 存在 浮 点 型 与 decimal 类 型 之 间 的 隐 式 转换 。 
e int 类 型 的 常数 表达 式 可 转换 为 sbyte、byte、short、ushort、uint 3È 


ulong， 前 提 是 常数 表达 式 的 值 处 于 目标 类 型 的 范围 之 内 。 
C# 32 SHE 
有 关 详 细 信 息 ， 请 人 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
请 参阅 


C# 参考 
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CH 编程 指南 

HUR (CH 参考 ) 

内 置 类 型 表 (CH 参考 ) 

显 式 数 值 转换 表 (CH 参考 ) 
强制 转换 和 类 型 转换 (CH 编程 指南 ) 


隐 式 数值 转换 表 (CH 参考 ) 669 


显 式 数值 转换 表 (CHA 


显 式 数值 转换 用 于 通过 显 式 转换 表达 式 ， 将 任何 数字 类 型 转换 为 任何 其 他 数字 类 
型 。 对 于 它 不 存在 隐 式 转换 。 下 表 显 示 了 这 些 转换 。 


有 关 转 换 的 更 多 信息 ， 请 参见 强制 转换 和 类 型 转换 (C# 编程 指南 ) 。 


源 目标 
sbyte byte、ushort、uint、ulong 或 char 
byte Sbyte 或 char 
short sbyte、byte、ushort、uint、ulong 或 char 


ushort sbyte. byte, short 或 char 


int sbyte. byte. short, ushort, 

uint sbyte. byte. short, ushort, 

long sbyte. byte. short, ushort, 

ulong sbyte. byte. short, ushort, 

char sbyte, byte 或 short 

float sbyte, byte, short, ushort, 
decimal 

dell sbyte、 byte, short, ushort, 
或 decimal 

decime sbyte, byte. short, ushort, 


或 double 


备注 


uint、ulong 或 char 


int 或 char 


int、uint、ulong 或 char 


int、 


int、 


int、 


int、 


e 显 式 数 值 转换 可 能 导致 精度 损失 或 引发 异常 。 


e 将 decimal 值 转换 为 整 型 时 ， 该 值 将 舍 入 为 与 才 最 接近 的 整数 值 。 如 果 结 果 整 
数值 超出 目标 类 型 的 范围 ， 则 会 引发 OverflowException。 
e 将 double & float 值 转换 为 整 型 时 ， 值 会 被 截断 。 如 果 该 结果 整数 值 超出 了 


目标 值 的 范围 ， 其 结果 将 取决 于 浴 出 检查 上 下 文 。 在 checked 上 下 文中 ， 将 引 
发 OverflowException ; 而 在 unchecked 上 下 文中 ， 结 果 将 是 一 个 未 指定 的 


目标 类 型 的 值 。 


uint, 


uint, 


uint, 


uint, 


long 或 char 


long, ulong, 
long, ulong. 


long, ulong, 


char 3X 


char, flo: 


char, flo: 


e 将 double 转换 为 float S, double 441 EE float 4, WR 
double 值 因 过 小 或 过 大 而 使 目标 类 型 无 法 容纳 它 ， 则 结果 将 为 需 或 无 穷 大 。 


e 将 float 或 double 转换 为 decimal 时 ， 源 值 季 转换 为 decimal 表示 形式 ， 并 
舍 入 为 第 28 个 小 数位 之 后 最 接近 的 数 GREE) 。 根 据 源 值 的 不 同 ， 可 能 
产生 以 下 结果 : 


o 如 果 源 值 因 过 小 而 无 法 表示 为 decimal， 那 么 结果 将 为 需 。 


o 如 果 源 值 为 NaN ( 非 数 字 值 ) 、 无 穷 大 或 因 过 大 而 无 法 表示 为 decimal, 
则 会 引发 OverflowException。 


将 decimal 转换 为 float 或 double 时 ，decimal 值 将 舍 人 为 最 接近 的 double 
或 float 值 。 


有 关 显 式 转换 的 更 多 信息 ， 请 参见 “C# 语言 规范 中 的 显 式 ”。 有 关 如 何 访问 此 规范 的 
更 多 信息 ， 请 参见 C# 语言 规范 。 


请 参阅 

CH 参考 

CH 编程 指南 

强制 转换 和 类 型 转换 (CH 编程 指南 ) 
() 运算 符 (CR 参考 ) 

整 型 表 (CH BS) 

HEXER (CH 参考 ) 

隐 式 数值 转换 表 (CHA) 


设置 数值 结果 表 的 格式 (CHA) 


通过 使 用 String.Format 方法 ， 或 者 通过 Console.Write 或 Console.WriteLine 方法 
(这 两 个 方法 会 调用 String.Format) ， 可 以 设置 数值 结果 的 格式 。 通 过 使 用 格式 

字符 串 指 定格 式 。 下 表 包 含 受 支 持 的 标准 格式 字符 串 。 格 式 字 符 串 采用 以 下 形 

式 : Axx, HHA 是 格式 说 明 符 ，xx 是 精度 说 明 符 。 格 式 说 明 符 控制 应 用 于 数值 的 

格式 类 型 ， 而 精度 说 明 符 则 控制 格式 化 输出 的 有 效 位 数 或 小 数位 数 。 精 度 说 明 符 的 

值 介 于 0 到 99。 


有 关 标 准 和 自 定义 格式 字符 串 的 更 多 信息 ， 请 参见 .NET Framework 中 的 格式 化 类 
型 。 有 关 String.Format 方法 的 更 多 信息 ， 请 参见 String.Format。 


描述 示例 Output 
; Console.Write("{0:C}", 
= 货 ; : 
C EC xm 2.5);Console.Write("{0:C}", -2.5); 92:50(82.50) 
Dd Decimal Console.Write("{0:D5}", 25); 00025 
Exe 科学 型 Console.Write("{0:E}", 250000); 2.500000E+005 
> Eis Console.Write("{0:F2}", 
= = 
PERO Dm 25);Console.Write("{0:FO}", 25); 29.0929 
Gzg 常规 Console.Write("{0:G}", 2.5); 2.5 
N 或 n 数字 Console.Write("(0:N)", 2500000); 2,500,000.00 
E 十 六 进 Console.Write("{0:X}", 
Aux 制 250);Console.Write("{0:X}", Oxffff); PATER 
请 参阅 
C4 参考 
C# 编程 指南 
标准 数字 格式 字符 串 


类 型 参考 表 (CH 参考 ) 
string (C# 参考 ) 


修饰 符 (CH 参考 ) 


修饰 符 用 于 修改 类 型 和 类 型 成 员 的 声明 。 本 节 介 绍 CH 修饰 符 。 


修饰 符 


访问 修饰 符 public private 
internal protected 


abstract 
async 


const 
event 
extern 
new 
override 


partial — 部 分 
readonly 


sealed 
static 


unsafe 


virtual 


volatile 
请 参阅 


C 编程 指南 
C# 关键 字 


用 途 
指定 声明 的 类 型 和 类 型 成 员 的 可 访问 性 。 


指示 某 个 类 只 能 是 其 他 类 的 基 类 。 


指示 修改 后 的 方法 、lambda 表达 式 或 匿名 方法 是 


异步 的 。 


指定 无 法 修改 字段 或 局 部 变量 的 值 。 

声明 事件 。 

指示 在 外 部 实现 方法 。 

显 式 隐藏 继承 自 基 类 的 成 员 。 

提供 从 基 类 继承 的 虚拟 成 员 的 新 实现 。 

在 同一 程序 集中 定义 分 部 类 、 结 构 和 方法 。 


声明 一 个 字段 ， 该 字段 只 能 赋值 为 该 声明 的 一 部 
分 或 者 在 同一 个 类 的 构造 函数 中 。 


指定 无 法 继承 类 。 

声明 属于 类 型 本 身 而 不 是 特定 对 象 的 成 员 。 
声明 不 安全 的 上 下 文 。 

在 派生 类 中 声明 其 实现 可 由 重 写成 员 更 改 的 方法 
或 访问 器 。 

指示 字段 可 在 程序 中 由 操作 系统 、 硬 件 或 并 发 执 
行 线程 等 项 修改 。 


访问 修饰 待 〈《C# 参考 ) 
访问 修饰 符 是 一 些 天 键 字 ， 用 于 指定 声明 的 成 员 或 类 型 的 可 访问 性 。 本 节 介 绍 四 个 
访问 修饰 符 : 
e public 
e protected 
e internal 
e private 
使 用 这 些 访问 修饰 符 可 指定 下 列 五 个 可 访问 性 级 别 : 
public : 访问 不 受 限 制 。 
protected : 访问 仅 限于 包含 类 或 从 包含 类 派生 的 类 型 。 
Internal : 访问 仅 限于 当前 程序 集 。 
protected internal: 访 问 限制 到 当前 程序 集 或 从 包含 派生 的 类 型 的 类 别 。 
private : 访问 仅 限于 包含 类 型 。 
本 节 还 介绍 以 下 内 容 : 
e 可 访问 性 级 别 : 使 用 四 个 访问 修饰 符 声明 五 个 可 访问 性 级 别 。 
e 可 访问 域 : 指定 在 程序 节 的 哪个 位 置 可 以 引用 成 员 。 
e 可 访问 性 级 别 的 使 用 限制 : 概述 了 声明 的 可 访问 性 级 别 的 使 用 限制 。 


请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

访问 修饰 符 (CH 编程 指南 ) 
访问 关键 字 (C# 参考 ) 
修饰 符 (CH 参考 ) 


可 访问 性 级 别 (CH 参考 ) 


使 用 访问 修饰 符 public, protected, internal 或 private 可 以 为 成 员 指定 以 下 声明 的 
访问 级 别 之 一 。 


声明 的 可 访问 性 Bx 
public 访问 不 受 限 制 。 
protected 访问 仅 限 于 包含 类 或 从 包含 类 派生 的 类 型 。 
internal 访问 仅 限 于 当前 程序 集 。 
protected internal 访问 仅 限于 从 包含 类 派生 的 当前 程序 集 或 类 型 。 
private 访问 仅 限于 包含 类 型 。 


一 个 成 员 或 类 型 只 能 有 一 个 访问 修饰 符 ， 但 使 用 protected**internal** 组 合 时 除 


命名 空间 上 不 允许 使 用 访问 修饰 符 。 命 名 空间 没有 访问 限制 。 


根据 出 现成 员 声 明 的 上 下 文 ， 只 人 允许 某 些 声明 的 可 访问 性 。 如 果 在 成 员 声 明 中 未 指 
定 访问 修饰 符 ， 则 使 用 默认 的 可 访问 性 。 


不 谋 套 在 其 他 类 型 中 的 顶级 类 型 的 可 访问 性 只 能 是 internal 或 public。 这 些 类 型 的 
默认 可 访问 性 是 internal。 


嵌 套 类 型 是 其 他 类 型 的 成 员 ， 它 们 可 以 具有 下 表 所 示 的 声明 的 可 访问 性 。 
默认 的 成 员 可 访 


属于 M. 该 成 员 人 允许 的 声明 的 可 访问 性 
enum public 无 
le private pu blic**protectedinternalprivate**protected 
internal 
interface public 无 
struct private public**internal**private 


谋 套 类 型 的 可 访问 性 取决 于 它 的 可 访问 域 ， 该 域 是 由 已 声明 的 成 员 可 访问 性 和 直接 
包含 类 型 的 可 访问 域 这 二 者 共同 确定 的 。 但 是 ， 嵌 套 类 型 的 可 访问 域 不 能 超出 包含 
类 型 的 可 访问 域 。 


CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语 闸 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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访问 修饰 符 (C# 参考 ) 
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public (C# 参考 ) 

private (C£ 参考 ) 
protected (C# 参考 ) 
internal (C£ 参考 ) 


可 访问 性 级 别 (CH 参考 ) 


676 


可 访问 域 (CH 参考 ) 


成 员 的 可 访问 域 指定 程序 中 可 以 引用 成 员 的 部 分 。 如 果 成 员 斤 套 在 其 他 类 型 中 ， 其 
可 访问 域 由 该 成 员 的 可 访问 性 级 别 和 直接 包含 类 型 的 可 访问 域 共 同 确定 。 


顶级 类 型 的 可 访问 域 至 少 是 声明 它 的 项 目的 程序 文本 。 也 就 是 说 ， 域 包括 此 项 目的 
所 有 源 文件 。 旋 套 类 型 的 可 访问 域 至 少 是 声明 它 的 类 型 的 程序 文本 ， 即 域 是 一 个 类 
型 体 ， 包 括 所 有 嵌 套 的 类 型 。 府 套 类 型 的 可 访问 域 决 不 能 超出 包含 类 型 的 可 访问 
域 。 这 些 概念 在 以 下 示例 中 加 以 说 明 。 


该 示例 包含 一 个 顶级 类 型 T1 和 两 个 世 套 类 M1 和 M2。 这 两 个 类 包含 具有 不 同 声明 
的 可 访问 性 的 字段 。 在 Main 方法 中 ， 每 个 语句 后 都 有 注释 ， 指 示 每 个 成 员 的 可 访 
问 域 。 注 意 ， 党 试 引用 不 可 访问 的 成 员 的 语句 被 注释 掉 了 。 如 果 希 望 查看 由 引用 不 
可 访问 的 成 员 所 导致 的 编译 器 错误 ， 请 逐个 移 除 注释 。 


namespace AccessibilityDomainNamespace 


{ 
public class T1 


{ 
public static int publicInt; 
internal static int internalInt; 
private static int privateInt - 0; 
static T1() 


{ 
// T1 can access public or internal members 
// in a public or private (or internal) nested class 
M1.publicInt = 1; 
Mi.internallInt = 2; 
M2.publicInt - 3; 
M2.internallInt = 4; 
// Cannot access the private member privateInt 
// in either class: 
// Mi.privateInt = 2; //CS0122 
} 


public class M1 


public static int publicint; 
internal static int internalInt; 
private static int privateInt - 0; 


j 


private class M2 


internal static int internalIn 
private static int privateInt 


public static int publicInt - 0; 
t 0; 


0; 


} 
class MainClass 
{ 
static void Main() 
{ 
// Access is unlimited: 
Ti.publicInt = 1; 
// Accessible only in current assembly: 
Ti.internalInt = 2; 
// Error CS0122: inaccessible outside T1: 
// T1.privateInt = 3; 
// Access is unlimited: 
T1.M1.publicInt = 1; 
// Accessible only in current assembly: 
T1.M1.internalInt = 2; 
// Error CS0122: inaccessible outside M1: 
// T1.M1.privateInt = 3; 
// Error CS0122: inaccessible outside T1: 
// T1.M2.publicInt - 1; 
// Error CS0122: inaccessible outside T1: 
// T1.M2.internalInt = 2; 
// Error CS0122: inaccessible outside M2: 
// T1.M2.privateInt = 3; 
// Keep the console open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规 函 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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public (C# 参考 ) 

private (C£ 参考 ) 

protected (C£ 参考 ) 

internal (C£ 参考 ) 
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可 访问 性 级 别 的 使 用 限制 (CH 参考 ) 

在 一 项 声明 中 指定 类 型 时 ， 请 检查 类 型 的 可 访问 性 级 别 是 否 依赖 成 员 或 其 他 类 型 的 
可 访问 性 级 别 。 例 如 ， 直 接 基 类 必须 至 少 与 派生 类 具有 同样 的 可 访问 性 。 以 下 声明 
导致 编译 器 错误 ， 因 为 基 类 BaseClass 的 可 访问 性 小 于 MyClass : 


class BaseClass {...} 
public class MyClass: BaseClass {...} // Error 


下 表 汇 总 了 对 声明 的 可 访问 性 级 别 的 限制 。 


上 下 文 备注 
x 类 类 型 的 直接 基 类 必须 至 少 与 类 类 型 本 身 具 有 同样 的 可 访问 性 。 
接口 接口 类 型 的 显 式 基 接 口 必须 至 少 与 接口 类 型 本 身 具 有 同样 的 可 访问 
性 。 
委托 类 型 的 返回 类 型 和 参数 类 型 必须 至 少 与 委托 类 型 本 身 具 有 同样 的 
委托 可 访问 性 。 


常量 常数 的 类 型 必须 至 少 与 常数 本 身 具有 同样 的 可 访问 性 。 
字段 字段 的 类 型 必须 至 少 与 字段 本 身 具 有 同样 的 可 访问 性 。 


方法 方法 的 返回 类 型 和 参数 类 型 必须 至 少 与 方法 本 身 具 有 同样 的 可 访问 
IES 


属性 属性 的 类 型 必须 至 少 与 属性 本 身 具有 同样 的 可 访问 性 。 

事件 事件 的 类 型 必须 至 少 与 事件 本 身 具 有 同样 的 可 访问 性 。 

索引 器 的 类 型 和 参数 类 型 必须 至 少 与 索引 器 本 身 有 具有 同样 的 可 访问 
性 


o 


索引 器 


cag 。” 芭 算 符 的 返回 类 型 和 参数 类 型 必须 至 少 与 运算 符 本 身 屋 有 同样 的 可 访 
: iz MES 

‘i KDE ERU BUR MANES 5 ARMAS BUB ET ie HE. 

下 面 的 示例 包含 不 同类 型 的 错误 声明 。 每 个 声明 后 的 注释 指示 了 预期 的 编译 器 错 


2 
IRo 


// Restrictions on Using Accessibility Levels 

// CS0052 expected as well as CS0053, CS0056, and CS0057 

// To make the program work, change access level of both class B 
// and MyPrivateMethod() to public. 


using System; 


// ^ delegate: 
delegate int MyDelegate(); 


class B 


1 
// A private method: 


static int MyPrivateMethod() 


{ 
return 0; 
} 
} 
public class A 
{ 


// Error: The type B is less accessible than the field A.myFie: 
public B myField - new B(); 


// Error: The type B is less accessible 
// than the constant A.myConst. 
public readonly B myConst - new B(); 


public B MyMethod() 


{ 
// Error: The type B is less accessible 
// than the method A.MyMethod. 
return new B(); 

j 


// Error: The type B is less accessible than the property A.Myt 
public B MyProp 


i 
set 
t 
} 

} 


MyDelegate d = new MyDelegate(B.MyPrivateMethod); 

// Even when B is declared public, you still get the error: 
// "The parameter B.MyPrivateMethod is not accessible due to 
// protection level." 


public static B operator +(A mi, B m2) 


f 
// Error: The type B is less accessible 
// than the operator A.operator +(A,B) 
return new B(); 

j 


static void Main() 


( 


Console.Write("Compiled successfully"); 
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可 访问 性 级 别 的 使 用 限制 (CH 参考 ) 682 


internal (Ct 27) 


internal 关键 字 是 类 型 和 类 型 的 成 员 访问 修饰 符 。 只 有 在 同一 程序 集 的 文件 中 ， 内 
部 类 型 或 成 员 才 是 可 访问 的 ， 如 下 例 所 示 : 
public class BaseClass 


// Only accessible within the same assembly 
internal static int x = 0; 


从 当前 程序 集 或 从 包含 类 派生 的 类 型 ， 可 以 访问 具有 访问 修饰 符 protected 
internal 的 类 型 或 成 员 。 


AX internal 与 其 他 访问 修饰 符 的 比较 ， 请 参见 可 访问 性 级 别 (CSS) 和 访问 
修饰 符 (CH 编程 指南 ) 。 


有 关 程 序 集 的 更 多 信息 ， 请 参见 程序 集 和 全 局 程序 集 缓存 (C£ 和 Visual Basic) 。 
内 部 访问 通常 用 于 基于 组 件 的 开发 ， 因 为 它 使 一 组 组 件 能 够 以 私有 方式 进行 合作 ， 
而 不 必 向 应 用 程序 代码 的 其 余部 分 公开 。 例 如 ， 用 于 生成 图 形 用 户 界 面 的 框架 可 以 
提供 Control 和 Form 类 ， 这 两 个 类 通过 使 用 具有 内 部 访问 权限 的 成 员 进 行 合 作 。 
由 于 这 些 成 员 是 内 部 的 ， 它 们 不 向 正在 使 用 框架 的 代码 公开 。 

从 定义 具有 内 部 访问 能 力 的 类 型 或 成 员 的 程序 集 外 部 引用 该 类 型 或 成 员 是 错误 的 。 
此 示例 包含 两 个 文件 : Assembly1.cs 和 Assembly1_a.cs。 第 一 个 文件 包含 内 部 基 
类 BaseClass。 在 第 二 个 文件 中 ， 实 例 化 BaseClass 的 党 斌 将 产生 错误 。 


// Assemblyi.cs 
// Compile with: /target:library 
internal class BaseClass 


public static int intM - 0; 


// Assemblyi_a.cs 
// Compile with: /reference:Assemblyi.dll 
class TestAccess 

static void Main() 


BaseClass myBase - new BaseClass(); // CS0122 


在 此 示例 中 ， 使 用 与 示例 1 中 所 用 的 文件 相同 的 文件 ， 并 将 BaseClass 的 可 访问 
性 级 别 更 改 为 public。 还 将 成 员 IntM 的 可 访问 性 级 别 更 改 为 internal。 在 此 例 
中 ， 您 可 以 实例 化 类 ， 但 不 能 访问 内 部 成 员 。 


// Assembly2.cs 
// Compile with: /target:library 
public class BaseClass 


{ 
} 


internal static int intM = 0; 


// Assembly2 a.cs 
// Compile with: /reference:Assemblyi.dll 
public class TestAccess 


{ 
static void Main() 
BaseClass myBase = new BaseClass(); // Ok. 
BaseClass.intM - 444; // CS0117 
} 
} 
NE 
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访问 修饰 符 (CH BA) 

可 访问 性 级 别 〈C# 参考 ) 

修饰 符 (CR 参考 ) 

public (C# 参考 ) 


private (C# 参考 ) 
protected (C£ 参考 ) 


private (C£ 参考 ) 


private 关键 字 是 一 个 成 员 访问 修饰 符 。 私有 访问 是 允许 的 最 低 访 问 级别 。 私有 成 
员 只 有 在 声明 它们 的 类 和 结构 体 中 才 是 可 访问 的 ， 如 下 例 所 示 : 
class Employee 


private int i; 
double d; // private access by default 


Fl — As FR B] ER S X Bt RT LAG je] ABE AY A o 
在 定义 私有 成 员 的 类 或 结构 外 引用 它 会 导致 编译 时 错误 。 


EX private 与 其 他 访问 修饰 符 的 比较 ， 请 参见 可 访问 性 级 别 〈C# 参考 ) 和 访问 修 
H&RF (CE 编程 指南 ) o 


示例 


在 此 示例 中 ，Employee 类 包含 两 个 私有 数据 成 员 name 和 salary, 作为 私有 成 
员 ， 它 们 只 能 通过 成 员 方 法 来 访问 。 添加 名 为 GetName 和 Salary 的 公共 方法 ， 

以 便 可 以 对 私有 成 员 进 行 受 控 的 访问 。 通过 公共 方法 访问 name 成 员 ， 而 通过 公共 
只 读 属 性 访问 salary 成 员 。 (有 关 更 多 信息 ， 请 参见 属性 (CH 编程 指南 ) 。) 


class Employee2 


{ 
private string name = "FirstName, LastName"; 
private double salary = 100.0; 
public string GetName() 
{ 
return name; 
} 
public double Salary 
{ 
get { return salary; } 
} 
} 
class PrivateTest 
{ 
static void Main() 
{ 
Employee2 e = new Employee2(); 
// The data members are inaccessible (private), 
// they can't be accessed like this: 
// string n = e.name; 
// double s = e.salary; 
// 'name' is indirectly accessed via method: 
string n = e.GetName(); 
// 'salary' is indirectly accessed via property 
double s - e.Salary; 
} 
} 
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可 访问 性 级 别 (CH 参考 ) 
修饰 符 (CH 参考 ) 
public (C# 参考 ) 
protected (C# 参考 ) 
internal (C£ 参考 ) 


private (C£ 参考 ) 
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protected (C# 24) 
protected 关键 字 是 一 个 成 员 访 问 修饰 符 。 受 保护 成 员 在 其 所 在 的 类 中 可 由 派生 类 
实例 访问 。 有 关 protected 与 其 他 访问 修饰 符 的 比较 ， 请 参见 可 访问 性 级 别 。 


只 有 在 通过 派生 类 类 型 发 生 访 问 时 ， 基 类 的 受 保护 成 员 在 派生 类 中 才 是 可 访问 的 。 
例如 ， 请 看 以 下 代码 段 : 


class A 
{ 
protected int x = 123; 
} 
class B : A 
{ 
static void Main() 
t 
A a - new A(); 
B b = new B(); 
// Error CS1540, because x can only be accessed by 
// classes derived from A. 
// a.x = 10; 
// OK, because this class derives from A. 
b.x - 10; 
J 
} 


语句 a.x = 10 生成 错误 ， 因 为 它 是 在 静态 方法 Main 中 生成 的 ， 而 不 是 类 BAK 
例 。 


结构 成 员 无 法 受 保护 ， 因 为 无 法 继承 结构 。 


此 示例 中 ，DerivedPoint 类 派生 自 Point。 因 此 ， 可 以 从 派生 类 直接 访问 基 类 的 受 
保护 成 员 。 


class Point 


{ 
protected int x; 
protected int y; 
j 
class DerivedPoint: Point 
{ 
static void Main() 
{ 
DerivedPoint dpoint = new DerivedPoint(); 
// Direct access to protected members: 
dpoint.x = 10; 
dpoint.y = 15; 
Console.WriteLine("x = {0}, y = {1}", dpoint.x, 
} 


// Output: x = 10, y = 15 


4 — —— Bind 


ASR X 和 y 的 访 问 级 别 更 改 为 private， 编译 器 将 发 出 错 误 信 息 AM e 
‘Point.y' is inaccessible due to its protection level. 


'Point.x' is inaccessible due to its protection level. 


CH ESI 
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internal (C£ 参考 ) 


protected (C£ 参考 ) 690 


public (C£ 参考 ) 


public 关键 字 是 类 型 和 类 型 成 员 的 访问 修饰 符 。 公 共 访 问 是 允许 的 最 高 访问 级 别 。 
对 访问 公共 成 员 没 有 限制 ， 如 下 例 所 示 : 


class SampleClass 


public int x; // No access restrictions. 


有 关 更 多 信息 ， 请 参见 访问 修饰 符 (CH 编程 指南 ) 和 可 访问 性 级 别 〈C# 参考 ) 。 


在 下 面 的 示例 中 ， 声 明了 两 个 类 : PointTest 和 MainClass, 直接 从 MainClass 访 
问 PointTest 的 公共 成 员 x 和 yo 


class PointTest 


public int x; 
public int y; 


} 
class MainClass4 
{ 
static void Main() 
{ 
PointTest p = new PointTest(); 
// Direct access to public members: 
p.x = 10; 
p.y = 
Console.WriteLine("x = {0}, y = {1}", p.x, p.y); 
} 


} 
// Output: x = 10, y = 15 


如 果 将 public 访问 级 别 更 改 为 private X protected， 您 将 收 到 错误 信息 : 
“PointTest.y" 不 可 访问 ， 因 为 它 受 保护 级 别 限制 。 


Ci iE 
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abstract (C# 27) 


abstract 修饰 符 指示 所 修饰 的 内 容 缺少 实现 或 未 完全 实现 。abstract 修饰 符 可 用 于 
类 、 方 法、 属性 、 索 引 器 和 事件 。 在 类 声明 中 使 用 abstract 修饰 符 以 指示 某 个 类 
只 能 是 其 他 类 的 基 类 。 标 记 为 抽象 或 包含 在 抽象 类 中 的 成 员 必 须 通过 从 抽象 类 派生 


的 类 来 实现 。 


在 此 例 中 ， 类 Square 必须 提供 Area 的 实现 ， 因 为 它 派 生 自 ShapesClass : 


abstract class ShapesClass 


{ 
} 


class Square : ShapesClass 


abstract public int Area(); 


int side - 0; 


public Square(int n) 
{ 


j 


// Area method is required to avoid 
// a compile-time error. 
public override int Area() 


side =n; 


{ 
return side * side; 
} 
static void Main() 
{ 
Square sq = new Square(12); 
Console.WriteLine("Area of the square = (0)", sq.Area()); 
} 


interface I 
void M(); 
abstract class C : I 


public abstract void M(); 


// Output: Area of the square - 144 
H - 








抽象 类 具有 以 下 特性 : 
。 抽象 类 不 能 实例 化 。 
。 抽象 类 可 以 包含 抽象 方法 和 抽象 访问 器 。 
e 不 能 用 sealed (CH 参考 ) 修饰 符 修 饰 抽象 类 ， 因 为 这 两 个 修饰 符 的 含义 是 相 
采用 sealed 修饰 符 的 类 无 法 继承 ， 而 abstract 修饰 符 要 求 对 类 进行 继 


e 从 抽象 类 派生 的 非 抽象 类 必须 包括 继承 的 所 有 抽象 方法 和 抽象 访问 器 的 实际 实 


现 。 
在 方法 或 属性 声明 中 使 用 abstract 修饰 符 以 指示 方法 或 属性 不 包含 实现 。 
抽象 方法 具有 以 下 特性 : 
。 抽象 方法 是 隐 式 的 虚 方 法 。 
e 只 人 允许 在 抽象 类 中 使 用 抽象 方法 声明 。 
。 因为 抽象 方法 声明 不 提供 实际 的 实现 ， 所 以 没有 方法 体 ; 方法 声明 只 是 以 一 个 
分 号 结束 ， 并 且 在 签名 后 没有 大 括号 ({ })。 例 如 : 


public abstract void MyMethod(); 


实现 由 一 个 重 写 方 法 override (Ct 参考 ) 提供 ， 此 重 写 方法 是 非 抽象 类 的 一 个 


Wo 
e 在 抽象 方法 声明 中 使 用 static 或 virtual 修饰 符 是 错误 的 。 
除了 在 声明 和 调用 语法 上 不 同 外 ， 抽 象 属性 的 行为 与 抽象 方法 一 样 。 
e 在 静态 属性 上 使 用 abstract 修饰 符 是 错误 的 。 


e 在 派生 类 中 ， 通 过 包括 使 用 override 修饰 符 的 属性 声明 ， 可 以 重 宇 抽象 的 继承 
属性 。 


有 关 抽 象 类 的 更 多 信息 ， 请 参见 抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) o 
抽象 类 必须 为 所 有 接口 成 员 提供 实现 。 
实现 接口 的 抽象 类 可 以 将 接口 方法 映射 到 抽象 方法 上 。 例 如 : 


interface I 


void M(); 
abstract class C : I 
i 

public abstract void M(); 
} 


在 本 例 中 ，DerivedClass 类 是 从 抽象 类 BaseClass 派生 的 。 抽 象 类 包含 一 个 抽象 
方法 AbstractMethod 和 两 个 抽象 属性 X 和 Y. 


abstract class BaseClass // Abstract class 


{ 
protected int _x = 100; 


protected int _y = 150; 

public abstract void AbstractMethod(); // Abstract method 
public abstract int X { get; } 

public abstract int Y { get; } 


} 


class DerivedClass : BaseClass 


t 
public override void AbstractMethod() 


public override int X // overriding property 


if 
get 


{ 
} 


return x + 10; 


} 


public override int Y // overriding property 


{ 
get 


{ 
} 


return y + 10; 


} 
static void Main() 


( 


DerivedClass o - new DerivedClass(); 

o.AbstractMethod(); 

Console.WriteLine("x = (0), y = {1}", o.X, o.Y); 
} 


// Output: x = 111, y = 161 


在 上 面 的 示例 中 ， 如 果 尝 试 通过 使 用 下 面 的 语句 将 抽象 类 实例 化 : 


BaseClass bc = new BaseClass(); // Error 


将 出 现 错误 ， 指 出 编译 器 无 法 创建 抽象 类 "BaseClass" 的 实例 。 


Bc q+ 

CH j2 Sas 
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override (C£ 参考 ) 
C# 关键 字 


async (C£ 2X) 


使 用 async 修饰 符 可 将 方法 、lambda 表达 式 或 匿名 方法 指定 为 异步 。 如 果 对 方法 
或 表达 式 使 用 此 修饰 符 ， 则 其 称 为 异步 方法 。 


public async Task<int> ExampleMethodAsync() 


"P ACE m 


如 果 你 不 熟悉 异步 编程 或 不 了 解 异 步 方 法 如 何 使 用 await 关键 字 来 完成 可 能 需要 长 
时 间 运 行 的 工作 而 不 阻止 调用 方 的 线程 ， 则 应 阅读 使 用 Async 和 Await 的 异步 编程 
(C# 和 Visual Basic) 中 的 简介 。 


string contents = await contentsTask; 


方法 将 同步 运行 ， 直 至 到 达 其 第 一 个 await 表达 式 ， 此 时 会 将 方法 挂 起 ， 直 到 等 待 
的 任务 完成 。 同 时 ， 如 下 节 示 例 中 所 示 ， 控 件 将 返回 到 方法 的 调用 方 。 


如 果 async 关键 字 修改 的 方法 不 包含 await 表达 式 或 语句 ， 则 该 方法 将 同步 执 
行 。 编 译 器 警告 将 通知 你 不 包含 await 的 任何 异步 方法 ， 因 为 该 情况 可 能 表示 存在 
错误 。 请 参见 编译 器 警告 (等 级 1) CS4014。 


async 关键 字 是 上 下 文 关键 字 ， 原 因 在 于 只 有 当 它 修饰 方法 、lambda 表达 式 或 匿 
名 方法 时 ， 它 才 是 关键 字 。 在 所 有 其 他 上 下 文中 ， 都 会 将 其 解释 为 标识 符 。 


示例 


下 面 的 示例 展示 了 异步 事件 处 理 程序 StartButton_Click 和 异步 方法 
ExampleMethodAsync 之 间 的 控制 结构 和 流程 。 此 异步 方法 得 到 的 结果 是 一 个 下 载 
网 站 的 关 度 。 此 代码 适用 于 在 Visual Studio 2013 中 创建 的 Windows Presentation 
Foundation (WPF) 应 用 或 Windows 应 用 商店 应 用 ; 请 参见 有 关 设 置 应 用 的 代码 注 
释 。 


// You can run this code in Visual Studio 2013 as a WPF app or a W: 
// You need a button (StartButton) and a textbox (ResultsTextBox). 
// Remember to set the names and handler so that you have somethint 
// «Button Content="Button" HorizontalAlignment-"Left" Margin-z"88,; 


// Click="StartButton_Click" Name="StartButton"/> 
// <TextBox HorizontalAlignment="Left" Height="137" Margin="88, 140, 
// Text="TextBox" VerticalAlignment="Top" Width="310" Name 


// To run the code as a WPF app: 

// paste this code into the MainWindow class in MainWindow.xaml 
// add a reference to System.Net.Http, and 

// add a using directive for System.Net.Http. 


// To run the code as a Windows Store app: 
// paste this code into the MainPage class in MainPage.xaml.cs, 
YA add using directives for System.Net.Http and System.Threadin‘ 


private async void StartButton Click(object sender, RoutedEventArg: 
{ 
// ExampleMethodAsync returns a Task<int>, which means that the 
// eventually produces an int result. However, ExampleMethodAs\ 
// the Task«int» value as soon as it reaches an await. 
ResultsTextBox.Text += "Xn"; 


try 
{ 
int length = await ExampleMethodAsync(); 
// Note that you could put "await ExampleMethodAsync()" in 
// "length" is, but due to when '+=' fetches the value of 上 
// would not see the global side effect of ExampleMethodAs\ 
ResultsTextBox.Text += String.Format("Length: {0}\n", lengi 
} 
catch (Exception) 
{ 
// Process the exception if one occurs. 
} 
} 
public async Task<int> ExampleMethodAsync() 
{ 
var httpClient = new HttpClient(); 
int exampleInt = (await httpClient.GetStringAsync("http://msdn 
ResultsTextBox.Text += "Preparing to finish ExampleMethodAsync 
// After the following return statement, any method that's awa: 
// ExampleMethodAsync (in this case, StartButton Click) can get 
// integer result. 
return exampleInt; 
} 
// Output: 


// Preparing to finish ExampleMethodAsync. 
// Length: 53292 








4 重要 事项 


有 关 各 项 任务 以 及 在 等 待 任务 期 间 所 执行 代码 的 更 多 信息 ， 请 参见 使 用 Async 
和 Await 的 异步 编程 (C# 和 Visual Basic) 。 有 关 使 用 类 似 元 素 的 完整 WPF 
示例 ， 请 参见 演练 : 使 用 Async 和 Await 访问 Web (C£ 和 Visual Basic) 。 你 
可 以 从 开发 人 员 代 码 示例 下 载 演练 代码 。 


返回 类 型 
异步 方法 的 返回 类 型 可 以 为 Task、Task<TResult> 或 void。 方 法 不 能 声明 任何 ref 
或 out 参数 ， 但 是 可 以 调用 具有 这 类 参数 的 方法 。 


如 果 异 步 方法 的 返回 语句 指定 一 个 TResult 类 型 的 操作 数 ， 则 你 应 指定 
Task«TResult» 作为 方法 的 返回 类 型 。 如 果 当 方法 完成 时 未 返回 有 意义 的 值 ， 则 应 
使 用 Task。 即 ， 对 方法 的 调用 将 返回 一 个 Task， 但 是 当 Task 完成 时 ， 任 何等 待 
Task 的 所 有 await 表达 式 的 计算 结果 都 为 void, 


你 应 主要 使 用 void 返回 类 型 来 定义 事件 处 理 程序 ， 这 些 人 处 理 程序 需要 此 返回 类 
型 。 void 返回 异步 方法 的 调用 方 不 能 等 待 ， 并 且 无 法 捕获 该 方法 引发 的 异常 。 


有 关 更 多 信息 和 示例 ， 请 参见 异步 返回 类 型 (C# 和 Visual Basic) 。 


请 参阅 
AsyncStateMachineAttribute 
await (Cit 参考 ) 


演练 : 使 用 Async 和 Await 访问 Web (C£ 和 Visual Basic) 
使 用 Async 和 Await 的 异步 编程 (C# 和 Visual Basic) 


const (C4 参考 ) 


使 用 const 关键 字 来 声明 某 个 常量 字段 或 常量 局 部 变量 。 常 量 字 段 和 常量 局 部 变量 
不 是 变量 并 且 不 能 修改 。 常 量 可 以 为 数字 、 布 尔 值 、 字 符 串 或 null 引用 。 不 要 创建 
常量 来 表示 你 需要 随时 更 改 的 信息 。 例 如 ， 不 要 使 用 常量 字段 来 存储 服务 的 价格 、 
产品 版 本 号 或 公司 的 品牌 名 称 。 这 些 值 会 随 着 时 间 发 生变 化 ; 因为 编译 器 会 传播 常 
i DU ean ede 
字 。 例 如 : 


const int x = 0; 
public const double gravitationalConstant - 6.673e-11; 
private const string productName = "Visual C#"; 


ex 
常数 声明 的 类 型 指定 声明 引入 的 成 员 类 型 。 常 量 局 部 变量 或 常量 字段 的 初始 值 设 定 
项 必须 是 一 个 可 以 隐 式 转换 为 目标 类 型 的 常量 表达 式 。 


常数 表达 式 是 在 编译 时 可 被 完全 计算 的 表达 式 。 因 此 ， 对 于 引用 类 型 的 常数 ， 可 能 
的 值 只 能 是 string 和 null 引用 。 


常数 声明 可 以 声明 多 个 常数 ， 例 如 : 


public const double x = 1.0, y = 2.0, z = 3.0; 


不 允许 在 常数 声明 中 使 用 static 修饰 符 。 
常数 可 以 参与 常数 表达 式 ， 如 下 所 示 : 


5 1 


public const int c1 : 
c1 + 100; 


public const int c2 


ur 注意 

readonly 关键 字 与 const K# FAA. const 字段 只 能 在 该 字段 的 声明 中 初始 
化 。 readonly 字段 可 以 在 声明 或 构造 画 数 中 初始 化 。 因 此 ， 根 据 所 使 用 的 构造 
Kg, readonly 字段 可 能 具有 不 同 的 值 。 另 外 ， 虽 然 const 字段 是 编译 时 常 
Æ, (E readonly 字段 可 用 于 运行 时 常量 ， 如 此 行 所 示 : public static readonly 
uint 11 = (uint)DateTime.Now.Ticks; 


public class ConstTest 


{ 
class SampleClass 
{ 
public int x; 
public int y; 
public const int c1 = 5; 
public const int c2 = c1 + 5; 
public SampleClass(int p1, int p2) 
{ 
X = pi; 
y = p2; 
} 
} 
static void Main() 
{ 
SampleClass mC = new SampleClass(11, 22); 
Console.WriteLine("x = (0), y = {1}", mC.x, mC.y); 
Console.writeLine("c1 = {0}, c2 = {1}", 
SampleClass.ci, SampleClass.c2 ); 
} 
/* Output 
x = 11, y = 22 
cil = 5, C2 = 710 
ny 


此 示例 说 明 如 何 将 常数 用 作 局 部 变量 。 


public class SealedTest 


t 
static void Main() 
{ 
const int c = 707; 
Console.WriteLine("My local constant = {0}", c); 
j 


// Output: My local constant - 707 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 


MSDN C# 编程 指南 & 参考 手册 2015 


CH 参考 

C# 编程 指南 

C# 关键 字 

修饰 符 (C# 参考 ) 
readonly (C# 2) 


const (C£ 2) 
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event (C# 参考 ) 


event 关键 字 用 于 在 发 行者 类 中 声明 事件 。 


下 面 的 示例 演示 如 何 声 明和 引发 将 EventHandler 用 作 基 础 委托 类 型 的 事件 。 有 关 
演示 如 何 使 用 泛 型 EventHandler<TEventArgs> 委托 类 型 、 如 何 订阅 事件 以 及 如 何 
创建 事件 处 理 程序 方法 的 完整 代码 示例 ， 请 参见 如 何 : 发 布 符合 NET Framework 
准则 的 事件 (C# 编程 指南 ) 。 


public class SampleEventArgs 

{ 
public SampleEventArgs(string s) { Text = s; } 
public String Text (get; private set;) // readonly 


public class Publisher 
{ 
// Declare the delegate (if using non-generic pattern). 
public delegate void SampleEventHandler(object sender, SampleE\ 


// Declare the event. 
public event SampleEventHandler SampleEvent; 


// Wrap the event in a protected virtual method 
// to enable derived classes to raise the event. 
protected virtual void RaiseSampleEvent() 
{ 
// Raise the event by using the () operator. 
if (SampleEvent != null) 
SampleEvent(this, new SampleEventArgs("Hello")); 





事件 是 特殊 类 型 的 多 路 广播 委托 ， 仅 可 从 声明 它们 的 类 或 结构 (发 行者 类 ) 中 调 
用 。 如 果 其 他 类 或 结构 订阅 了 该 事件 ， 则 当 发 行者 类 引发 该 事件 时 ， 会 调用 其 事件 
处 理 程 序 方法 。 有 关 更 多 信息 和 代码 示例 ， 请 参见 事件 (CH 编程 指南 ) 和 委托 
(C? 编程 指南 ) o 


事件 可 标记 为 public, private, protected, internal 或 protected**internal**。 这 些 
访问 修饰 符 定义 类 的 用 户 访问 事件 的 方式 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 
(C# 编程 指南 ) 。 


天 键 字 和 事件 


下 面 的 关键 字 可 应 用 于 事件 。 


关键 字 说 明 更 多 信息 


cbe 即使 类 没有 实例 ， 调 用 方 也 能 在 任何 时 候 使 ” 静态 类 和 静态 类 成 


用 该 事件 。 A (CH 编程 指南 ) 
Virtual ”分 许 派生 类 通过 使 用 override 关键 字 来 重 宇 。 ”继承 (CH 编程 指 
事件 行为 。 南 ) 


sealed 指定 对 于 派生 类 它 不 再 属 虚 拟 性 质 。 


编译 器 不 会 生成 add 和 remove 事件 访问 器 


abstract 块 ， 因 此 派生 类 必须 提供 自己 的 实现 。 


通过 使 用 static 关键 字 ， 可 以 将 事件 声 明 为 静态 事件 。 Pa aA 调用 
方 也 能 在 任何 时 候 使 用 静态 事件 。 有 关 更 多 信息 ， 请 参见 前 态 类 和 前 态 类 成 员 
(C? 编程 指南 ) 。 


通过 使 用 virtual 关键 字 ， 可 以 将 事件 标记 为 虚拟 事件 。 这 样 ， 派 生 类 就 可 以 通过 使 
用 override 关键 字 来 重 写 事 件 行为 。 有 关 更 多 信息 ， 请 参见 继承 (C4 编程 指 
南 ) 。 重 写 虚 事件 的 事件 也 可 以 为 sealed， 以 表示 其 对 于 派生 类 不 再 是 虚 事 件 。 最 
后 ， 可 以 将 事件 声明 为 abstract， 这 意味 着 编译 器 不 会 生成 add 和 remove 事件 访 
问 器 块 。 因 此 派生 类 必须 提供 其 自己 的 实现 。 


CH EA 


有 关 详 细 信 息 ， 请 参阅 CHGERSGUUD. ÓSuUBRBAGUIEÉCHIIATURIAB AS. 


请 参阅 

C4 参考 

C# 编程 指南 

C# 关键 字 

add (C£ 参考 ) 

remove (C£ 参考 ) 

修饰 符 (C# 参考 ) 

如 何 : 合并 委托 (多 路 广播 委托 ) (CH 编程 指南 ) 


extern (C£ 2) 


extern 修饰 符 用 于 声明 在 外 部 实现 的 方法 。 extern 修饰 符 的 常见 用 法 是 在 使 用 
Interop 服务 调 入 非 托管 代码 时 与 DIIImport 特性 一 起 使 用 。 在 这 种 情况 下 ， 还 必须 
将 方法 声明 为 static， 如 下 面 的 示例 所 示 : 


[DllImport("avifil32.d11")] 
private static extern void AVIFileInit(); 


extern 关键 字 还 可 以 定义 外 部 程序 集 别 名 ， 使 得 可 以 从 单个 程序 集中 引用 同一 组 件 
的 不 同 版 本 。 有 关 详 细 信 息 ， 请 参阅 外 部 别名 (C# 参考 ) 。 


将 abstract 和 extern 修饰 符 一 起 使 用 来 修改 同一 成 员 是 错误 的 做 法 。 使 用 extern 
修饰 符 意 味 着 方法 是 在 C# 代码 的 外 部 实现 的 ， 而 使 用 abstract 修饰 符 意味 着 类 中 
未 提供 方法 实现 。 


extern 关键 字 用 于 CH 中 时 会 比 用 于 C++ 中 时 受到 更 多 的 限制 。 若 要 比较 CH 关键 
字 与 C++ 关键 字 ， 请 参见 C++ 语言 参考 中 的 “使 用 extern 指定 链接 ”。 


示例 1. 在 此 示例 中 ， 程 序 接收 来 自用 户 的 字符 串 并 将 该 字符 串 显 示 在 消息 框 中 。 程 
序 使 用 从 User32.dll 库 导 入 的 MessageBox 方法 。 


//using System.Runtime.InteropServices; 
class ExternTest 


{ 
[DllImport("User32.dll", CharSet=CharSet.Unicode) ] 
public static extern int MessageBox(IntPtr h, string m, string 
static int Main() 
string myString; 
Console.Write("Enter your message: "); 
myString = Console.ReadLine(); 
return MessageBox((IntPtr)O, myString, "My Message Box", 0 
} 
} 





示例 2. UEP TIA C 库 (本 机 DLL) 的 C# 程序 。 
1. 创 建 以 下 C 文件 并 将 其 命名 为 cmdll.c : 


// cmdll.c 

// Compile with: /LD 

int | declspec(dllexport) SampleMethod(int i) 
{ 


} 


return i*10; 


2.M Visual Studio 安装 目录 打开 Visual Studio x64 (3 x32) 本 机 工具 命令 提示 符 
窗口 ， 并 通过 在 命令 提示 符 外 键入 cl /LD cmdll.c 来 编译 cmdll.c 文件 。 


3. 在 相同 的 目录 中 ， 创 建 以 下 C# 文件 并 将 其 命名 为 cm.cs : 


// cm.cs 

using System; 

using System.Runtime.InteropServices; 
public class MainClass 


{ 
[DllImport("Cmd11.d11")] 
public static extern int SampleMethod(int x); 
static void Main() 
Console.WriteLine("SampleMethod() returns {0}.", SampleMethoxc 
} 
} 





3.M Visual Studio 安装 目录 打开 一 个 Visual Studio x64 (3X x32) 本 机 工具 命令 提 
示 符 窗口 ， 并 通过 键入 以 下 内 容 来 编译 cm.cs 文件 : 


csc cm.cs (针对 x64 命令 提示 符 ) 


。 或 - 


csc /platform:x86 cm.cs (针对 x32 命令 提示 符 ) 
这 将 创建 可 执行 文件 cm.exe。 


4. 运 行 cm.exe。 SampleMethod 方法 将 值 5 传递 到 DLL 文件 ， 这 将 返回 该 值 与 
10 相 乘 后 的 结果 。 程 序 生 成 以 下 输出 : 


SampleMethod() returns 50. 


CH 话 言 规 泄 


有 关 详 细 信 息 ， 请 参阅 CH 1% B. 该 语 言 规范 Jb 2L 是 CH 语 法 和 用 法 的 权威 资 料 。 
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请 参阅 
System.Runtime.InteropServices.DllImportAttribute 
CH 参考 

C# 编程 指南 

CH 关键 字 

修饰 符 (CH 参考 ) 


extern (C£ 参考 ) 708 


in 〈 沁 型 修饰 符 ) (CH 参考 ) 


对 于 泛 型 类 型 参数 ，in 关键 字 指定 该 类 型 参数 是 道 变 的 。 可 以 在 泛 型 接口 和 委托 中 
使 用 in 关键 字 。 


通过 逆 变 ， 可 以 使 用 与 泛 型 参数 指定 的 派生 类 型 相 比 ， 派 生 程度 更 小 的 类 型 。 这 样 
可 以 对 委托 类 型 和 实现 变 体 接口 的 类 进行 隐 式 转换 。 引 用 类 型 支持 泛 型 类 型 参数 中 
的 协 变 和 逆 变 ， 但 值 类 型 不 支持 。 


在 泛 型 接口 或 委托 中 ， 如 果 类 型 形 参 仅 用 作 方 法 返回 类 型 ， 而 不 用 于 方法 实 参 ， 则 
可 声明 为 协 变 的 。 Ref 和 out 参数 不 能 为 变 体 。 


如 果 接 口 具 有 道 变 类 型 形 参 ， 则 人 允许 其 方法 接受 与 接口 类 型 形 参 指定 的 派生 类 型 相 
比 ， 派 生 程 度 更 小 的 类 型 的 实 参 。 例 如 ， 由 于 在 .NET Framework 4 的 
IComparer<T> 接口 中 ， 类 型 下 是 逆 变 的 ， 因 此 如 果 Employee 继承 Person, nÆ 
需 使 用 任何 特殊 转换 方法 ， 就 可 以 将 IComparer(Of Person) 类 型 的 对 象 指派 给 
IComparer(Of Employee) 类 型 的 对 象 。 


可 以 向 逆 变 委托 分 配 同 一 类 型 的 其 他 委托 ， 但 需 使 用 派生 程度 较 小 的 泛 型 类 型 参 


有 关 更 多 信息 ， 请 参见 协 变 和 逆 变 (C# 和 Visual Basic) 。 


下 例 演示 如 何 声明 、 扩 展 和 实现 一 个 逆 变 泛 型 接口 。 此 外 还 演示 了 如 何 对 实现 此 接 
口 的 类 使 用 隐 式 转换 。 


// Contravariant interface. 
interface IContravariant<in A> { } 


// Extending contravariant interface. 
interface IExtContravariant<in A> : IContravariant<A> { } 


// Implementing contravariant interface. 
class Sample<A> : IContravariant<A> { } 


class Program 


i 


static void Test() 


new Sample<Object>(); 
new Sample<String>(); 


IContravariant<Object> iobj = 
IContravariant«String» istr = 
// You can assign iobj to istr because 

// the IContravariant interface is contravariant. 
istr = iobj; 


下 例 演示 如 何 声明 、 实 例 化 和 调用 一 个 道 变 泛 型 委托 。 此 外 还 演示 了 如 何 隐 式 转换 
委托 类 型 


// Contravariant delegate. 
public delegate void DContravariant<in A>(A argument); 


// Methods that match the delegate signature. 
public static void SampleControl(Control control) 


{ } 
public static void SampleButton(Button button) 


{} 


public void Test() 
{ 


// Instantiating the delegates with the methods. 
DContravariant<Control> dControl = SampleControl; 
DContravariant<Button> dButton = SampleButton; 

// You can assign dControl to dButton 

// because the DContravariant delegate is contravariant. 
dButton = dControl; 


// Invoke the delegate. 
dButton(new Button()); 


有 关 详 细 信 息 ， 请 参阅 C# 5D. AAE GE C# 语法 和 用 法 的 权威 资料 。 


请 参阅 
out ( 泛 型 修饰 符 ) (CR 参考 ) 


ih AGE (C# Visual Basic) 
修饰 符 (C# BS) 


out 〈 沁 型 修饰 符 ) (CH 参考 ) 


对 于 泛 型 类 型 参数 ，out 关键 字 指定 该 类 型 参数 是 协 变 的 。 可 以 在 泛 型 接口 和 委托 
中 使 用 out 关键 字 。 


通过 协 变 ， 可 以 使 用 与 泛 型 参数 指定 的 派生 类 型 相 比 ， 派 生 程 度 更 大 的 类 型 。 这 样 
可 以 对 委托 类 型 和 实现 变 体 接口 的 类 进行 隐 式 转换 。 引 用 类 型 支持 协 变 和 逆 变 ， 但 
值 类 型 不 支持 。 

如 果 接 口 具 有 协 变 类 型 形 参 ， 则 人 允许 其 方法 返回 与 接口 类 型 形 参 指定 的 派生 类 型 相 
比 ， 派 生 程 度 更 大 的 类 型 的 实 参 。 例 如 ， 由 于 在 .NET Framework 4 的 
IEnumerable<T> 接口 中 ， 类 型 T 是 协 变 的 ， 因 此 无 需 使 用 任何 特殊 转换 方法 就 可 
以 将 IEnumerabe(Of String) 类 型 的 对 象 分 配给 IEnumerable(Of Object) 类 型 的 对 
象 。 


可 以 向 协 变 委托 分 配 同 一 类 型 的 其 他 委托 ， 但 需 使 用 派生 程度 较 大 的 泛 型 类 型 参 


o 


有 关 更 多 信息 ， 请 参见 协 变 和 逆 变 (C# Visual Basic) 。 


下 例 演示 如 何 声明 、 扩 展 和 实现 一 个 协 变 泛 型 接口 。 此 外 还 演示 了 如 何 对 实现 协 变 
接口 的 类 使 用 隐 式 转换 。 


N 


// Covariant interface. 
interface ICovariant<out R» ( } 


// Extending covariant interface. 
interface IExtCovariant<out R» : ICovariant<R> { } 


// Implementing covariant interface. 
class Sample<R> : ICovariant<R> { } 


class Program 


{ 
static void Test() 
{ 
ICovariant«Object» iobj = new Sample<Object>(); 
ICovariant«String» istr = new Sample<String>(); 
// You can assign istr to iobj because 
// the ICovariant interface is covariant. 
iobj = istr; 
} 
} 


在 泛 型 接口 中 ， 当 符合 下 列 条 件 时 ， 可 以 将 类 型 参数 声明 为 是 协 变 的 。 
e 类 型 形 参 仅 用 作 接 口 方法 的 返回 类 型 ， 不 用 作 方 法 实 参 的 类 型 。 


ote 
Ej TER 


此 规则 有 一 个 例外 。 如 果 在 协 变 接口 中 ， 包 含 用 作 方 法 参数 的 逆 变 泛 型 委托 ， 
则 可 以 将 协 变 类 型 用 作 此 委托 的 泛 型 类 型 参数 。 有 关 协 变 和 逆 变 泛 型 委托 的 更 
多 信息 ， 请 参见 委托 中 的 变 体 (C# 和 Visual Basic) 和 对 Func 和 Action 泛 型 
委托 使 用 变 体 (C# 和 Visual Basic) 。 


e 类 型 参数 不 用 作 接 口 方 法 的 泛 型 约束 。 


下 例 演示 如 何 声明 、 实 例 化 和 调用 一 个 协 变 泛 型 委托 。 此 外 还 演示 了 如 何 隐 式 转换 


// Covariant delegate. 
public delegate R DCovariant«out R»(); 


// Methods that match the delegate signature. 
public static Control SampleControl() 
{ return new Control(); } 


public static Button SampleButton() 
{ return new Button(); ) 


public void Test() 

{ 
// Instantiate the delegates with the methods. 
DCovariant«Control» dControl - SampleControl; 
DCovariant«Button» dButton - SampleButton; 


// You can assign dButton to dControl 
// because the DCovariant delegate is covariant. 
dControl - dButton; 


// Invoke the delegate. 
dControl(); 


在 泛 型 委托 中 ， 如 果 类 型 仅 用 作 方 法 返回 类 型 ， 且 不 用 于 方法 参数 ， 则 可 声明 为 是 


Sean te 
CH j2 5s 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 规范 是 CH 语法 和 用 法 的 权威 资料 。 
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泛 型 接口 中 的 变 体 (C# 和 Visual Basic) 
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in 〈 泛 型 修饰 符 ) (CH 参考 ) 
修饰 符 (CH 参考 ) 


out 〈 泛 型 修饰 符 ) (CH 参考 ) 713 


override (Cft 参考 ) 


要 扩展 或 修改 继承 的 方法 、 属 性 、 索 引 器 或 事件 的 抽象 实现 或 虚实 现 ， 必 须 使 用 


override 修饰 符 。 


在 此 示例 中 ，Square 类 必须 提供 Area 的 重 写 实现 ， 因 为 Area 继承 自 抽象 的 


ShapesClass : 


abstract class ShapesClass 
abstract public int Area(); 


class Square : ShapesClass 


( 


int side - 0; 


public Square(int n) 


( 


side = n; 


// Area method is required to avoid 
// a compile-time error. 
public override int Area() 


{ 
return side * side; 
} 
static void Main() 
{ 
Square sq = new Square(12); 
Console.WriteLine("Area of the square = {0}", 
} 
interface I 
void M(); 
abstract class C : I 
{ 
public abstract void M(); 
} 


// Output: Area of the square = 144 
E 








override 方法 提供 从 基 类 继承 的 成 员 的 新 实现 。 由 override 声明 重 写 的 方法 称 为 
重 写 基 方 法 。 重 写 的 基 方 法 必须 与 override 方法 具有 相同 的 签名 。 有 关 继 承 的 信 
息 ， 请 参见 继承 (CH 编程 指南 ) 。 


不 能 重 写 非 虚 方 法 或 静态 方法 。 重 写 的 基 方 法 必须 是 virtual, abstract 或 
override 的 。 


override 声明 不 能 更 改 virtual 方法 的 可 访问 性 。 override 方法 和 virtual 方法 必 
须 具 有 相同 的 访问 级 别 修饰 符 。 


您 不 能 使 用 new、static 或 virtual 修饰 符 来 修改 override 方法 。 


重 写 属性 声明 必须 指定 与 继承 属性 完全 相同 的 访问 修饰 符 、 类 型 和 名 称 ， 并 且 被 重 
写 的 属性 必须 是 virtual, abstract 或 override 的 。 


有 关 如 何 使 用 override 关键 字 的 更 多 信息 ， 请 参见 使 用 Override 和 New 关键 字 
进行 版 本 控制 (CH 编程 指南 ) 和 了 解 何 时 使 用 Override 和 New 关键 字 。 


此 示例 定义 了 一 个 名 为 Employee 的 基 类 和 一 个 名 为 SalesEmployee 的 派生 类 。 
SalesEmployee 类 包括 一 个 额外 的 属性 salesbonus， 并 重 写 方法 CalculatePay 以 
便 将 该 属性 考虑 在 内 。 


class TestOverride 


{ 
public class Employee 
{ 
public string name; 
// Basepay is defined as protected, so that it may be 
// accessed only by this class and derrived classes. 
protected decimal basepay; 
// Constructor to set the name and basepay values. 
public Employee(string name, decimal basepay) 
{ 
this.name = name; 
this.basepay = basepay; 
} 
// Declared virtual so it can be overridden. 
public virtual decimal CalculatePay() 
1 
return basepay; 
} 
} 


// Derive a new class from Employee. 

public class SalesEmployee : Employee 

{ 
// New field that will affect the base pay. 
private decimal salesbonus; 


we 


// The constructor calls the base-class version, and 

// initializes the salesbonus field. 

public SalesEmployee(string name, decimal basepay, 
decimal salesbonus) : base(name, basepay) 

{ 


} 


// Override the CalculatePay method 
// to take bonus into account. 
public override decimal CalculatePay() 


this.salesbonus = salesbonus; 


{ 
return basepay + salesbonus; 
} 
} 
static void Main() 
{ 
// Create some new employees. 
SalesEmployee employee1 = new SalesEmployee("Alice", 
1000, 500); 
Employee employee2 = new Employee("Bob", 1200); 
Console.WriteLine("Employee4 " + employee1.name + 
" earned: " + employee1.CalculatePay()); 
Console.WriteLine("Employee4 " + employee2.name + 
" earned: " + employee2.CalculatePay()); 
} 
Output: 


Employee4 Alice earned: 1500 
Employee4 Bob earned: 1200 


C# ; Ta ZEE rel 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资 
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继承 (CH 编程 指南 ) 


CH 关键 字 


料 。 
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修饰 符 (CR 参考 ) 
abstract (C# 参考 ) 
virtual (C£ 参考 ) 

new (C£ 参考 ) 
SAE (CH 编程 指南 ) 


override (C£ 参考 ) 
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readonly (C£ 参考 ) 


readonly 关键 字 是 可 以 在 字段 上 使 用 的 修饰 符 。 当 字段 声明 包括 readonly 修饰 符 
时 ， 该 声明 引入 的 字段 赋值 只 能 作为 声明 的 一 部 分 出 现 ， 或 者 出 现在 同一 类 的 构造 
函数 中 。 

在 此 示例 中 ， 字 段 year 的 值 无 法 在 ChangeYear ASAP BK, BEE X MISH 
PY A T Bo 


class Age 


{ 
readonly int _year; 
Age(int year) 
_year = year; 


void ChangeYear() 


// year - 1967; // Compile error if uncommented. 


只 能 在 下 列 上 下 文中 对 readonly 字段 进行 赋值 : 
e 当 在 声明 中 初始 化 变量 时 ， 例 如 : 


public readonly int y = 5; 


e FIFRE, TEGLSTEERPSBHEN E B93z Bl MMH; 或 者 ， 对 于 静态 字 
E, EFOSFR BHM AMAA MENA, HRAGREL EH, 4 
readonly 字段 作为 out 或 ref 参数 传递 才 有 效 。 


8 注意 
readonly 关键 字 与 const 关键 字 不 同 。 const 字段 只 能 在 该 字段 的 声明 中 初始 
化 。 readonly 字段 可 以 在 声明 或 构造 画 数 中 初始 人 化。 因此， 根据 所 使 用 的 构造 


IR, readonly 字段 可 能 具有 不 同 的 值 。 另 外 ，const 字段 为 编译 时 常数 ， 而 
readonly 字段 可 用 于 运行 时 常数 ， 如 下 例 所 示 : 


public static readonly uint timeStamp = (uint)DateTime.Now.Ticks; 


«| TIE 





public class ReadOnlyTest 
X 
class SampleClass 
1 
public int x; 
// Initialize a readonly field 
public readonly int y - 25; 
public readonly int z; 


public SampleClass() 
{ 


// Initialize a readonly instance field 
Z = 24; 
} 


public SampleClass(int pi, int p2, int p3) 
{ 


x 
y 
Z 


HoHn d 
"o 
N 


} 
} 


static void Main() 

{ 
SampleClass pi = new SampleClass(11, 21, 32); // OK 
Console.WriteLine("p1: x-(0), y={1}, z={2}", pi.x, pi.y, pi.: 
SampleClass p2 - new SampleClass(); 
p2.x = 55; // OK 
Console.WriteLine("p2: x-(0), y={1}, z={2}", p2.x, p2.y, p2.: 


Output: 
pi: x-11, y=21, z-32 
p2: x-55, y-25, z-24 





在 前 面 的 示例 中 ， 如 果 使 用 这 样 的 语句 : 
p2.y = 66; // Error 
将 收 到 编译 器 错误 信息 : 


The left-hand side of an assignment must be an l-value 


这 和 与 尝试 料 值 赋 给 常数 时 收 到 的 错误 相同 。 
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sealed (Cf 27) 


当 对 一 个 类 应 用 sealed 修饰 符 时 ， 此 修饰 符 会 阻止 其 他 类 从 该 类 继承 。 在 下 面 的 
示例 中 ， 类 B 从 类 A 继承， 但 是 任何 类 都 不 能 从 类 B 继承 。 


class A {} 
sealed class B : A (3 


i HL ELE BS SERE A PRA RUE IR EDU S SR URL ETE sealed 修饰 符 。 这 将 
使 您 能 够 允许 类 从 您 的 类 继承 ， 并 防止 它们 重 写 特 定 的 虚 方法 或 虚 属性 。 


在 下 面 的 示例 中 ，Z 从 YY 继承 ， 但 Z 无 法 重 写 在 X 中 声明 并 在 Y 中 密封 的 虚 函 数 
Fo 


class X 


{ 
protected virtual void F() ( Console.WriteLine("X.F"); } 


protected virtual void F2() { Console.WriteLine("X.F2"); } 
class Y : X 


sealed protected override void F() { Console.WriteLine("Y.F"); 
protected override void F2() ( Console.WriteLine("Y.F2"); } 


class Z : Y 
1 


// Attempting to override F causes compiler error CS0239. 
// protected override void F() ( Console.WriteLine("C.F"); } 


// Overriding F2 is allowed. 
protected override void F2() ( Console.WriteLine("Z.F2"); } 





当 在 类 中 定义 新 的 方法 或 属性 时 ， 通 过 不 将 这 些 方法 或 属性 声明 为 virtual， 可 防止 
派生 类 重 写 这 些 方 法 或 属性 。 


将 abstract 修饰 符 用 于 密封 类 是 错误 的 做 法 ， 因 为 抽象 类 必须 由 提供 抽象 方法 或 属 
性 的 实现 的 类 继承 。 


当 应 用 于 方法 或 属性 时 ，sealed 修饰 符 必须 始终 与 override 一 起 使 用 。 
由 于 结构 是 隐 式 密封 的 ， 因 此 它们 不 能 被 继承 。 

有 关 更 多 信息 ， 请 参见 继承 (CH 编程 指南 ) o 

有 关 更 多 示例 ， 请 参见 抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) 。 


sealed class SealedClass 


public int x; 
public int y; 


} 
class SealedTest2 
{ 
static void Main() 
{ 
SealedClass sc = new SealedClass(); 
sc.x = 110; 
sc.y = 150; 
Console.WriteLine("x = {0}, y = {1}", sc.x, sc.y); 
} 


// Output: x = 110, y = 150 


在 上 一 个 示例 中 ， 您 可 能 尝试 使 用 下 面 的 语句 从 密封 类 继承 : 
class MyDerivedC: SealedClass {} // Error 
将 产 生 一 条 错误 消息 : 


'MyDerivedC' cannot inherit from sealed class 'SealedClass'. 
g = q+ 

CH BAG 
有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
备注 
若 要 确定 是 否 密封 类 、 方法 或 属性 ， 通 常 应 考虑 以 下 两 点 : 

。 派生 类 利用 自 定义 类 的 功能 所 获得 的 可 能 好 人 多。 

。 派生 类 在 修改 类 之 后 导致 其 无 法 正常 工作 或 按 预期 工作 的 可 能 性 。 
请 参阅 
C# 参考 
C# 编程 指南 


CH 关键 字 
静态 类 和 静态 类 成 员 (CH 编程 指南 ) 
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static (C# BS) 


使 用 static 修饰 符 声 明 属 于 类 型 本 身 而 不 是 属于 特定 对 象 的 静态 成 员 。 static 修饰 
符 可 用 于 类 、 字 段 、 方 法 、 属 性 、 运 算 符 、 事 件 和 构造 画 数 ， 但 不 能 用 于 索引 器 、 
析 构 画 数 或 类 以 外 的 类 型 。 有 关 更 多 信息 ， 请 参见 静态 类 和 静态 类 成 员 (C# 编程 
指南 ) 。 


下 面 的 类 声明 为 static， 并 且 只 包含 static 方法 : 


static class CompanyEmployee 


public static void DoSomething() { /*...*/ } 
public static void DoSomethingElse() { /*...*/ } 


常数 或 者 类 型 声明 隐 式 地 是 静态 成 员 。 
不 能 通过 实例 引用 静态 成 员 。 然 而 ， 可 以 通过 类 型 名 称 引用 它 。 例 如 ， 请 考虑 以 下 


public class MyBaseC 


{ 
public struct MyStruct 
{ 
public static int x = 100; 
} 
} 


若 要 引用 静态 成 员 x， 请 使 用 完全 限定 名 MyBaseC.MyStruct.x， 除 非 可 从 相同 范围 
访问 成 员 : 


Console.WriteLine(MyBaseC.MyStruct.x); 


尽管 类 的 实例 包含 该 类 所 有 实例 字段 的 单独 副本 ， 但 每 个 静态 字段 只 有 一 个 副本 。 
不 可 以 使 用 this 来 引用 静态 方法 或 属性 访问 器 。 
如 果 对 类 应 用 static 关键 字 ， 则 该 类 的 所 有 成 员 都 必须 是 静态 的 。 


下 
时 刻 调 用 。 


= 
Ef TER 


static 关键 字 在 使 用 上 上 比 在 C++ 中 有 更 多 限制 。 若 要 与 C++ 关键 字 比 较 ， 请 参 
见 Static (C++)。 


为 了 说 明 静 态 成 员 ， 请 看 一 个 表示 公司 历 员 的 类 。 假 设 该 类 包含 一 种 对 层 员 计数 的 
方法 和 一 个 存储 历 员 数 的 字段 。 该 方法 和 字段 都 不 属于 任何 实例 历 员 ， 而 是 属于 公 
司 类 。 因 此 ， 应 该 将 它们 声明 为 此 类 的 静态 成 员 。 


此 示例 读 取 新 屋 员 的 姓名 和 ID， 将 履 员 计数 器 加 一 ， 并 显示 新 层 员 的 信息 和 新 的 层 


员 数 。 为 简单 起 见 ， 该 程序 从 键盘 读 取 当 前 的 屠 员 数 。 在 实际 的 应 用 中 ， 应 从 文件 
读 取 此 信息 。 


public class Employee4 


public string id; 
public string name; 


public Employee4() 


{ 
} 


public Employee4(string name, string id) 


{ 


} 


this.name = name; 
this.id = id; 


public static int employeeCounter; 


public static int AddEmployee() 


1 


} 
} 


return ++employeeCounter; 


class MainClass : Employee4 


( 


static void Main() 


{ 


Console.Write("Enter the employee's name: "); 
string name - Console.ReadLine(); 
Console.Write("Enter the employee's ID: "); 
string id - Console.ReadLine(); 


// Create and configure the employee object: 
Employee4 e = new Employee4(name, id); 


Console.Write("Enter the current number of employees: 


string n - Console.ReadLine(); 
Employee4.employeeCounter - Int32.Parse(n); 
Employee4.AddEmployee(); 


7): 


// Display the new information: 
Console.WriteLine("Name: {0}", e.name); 
Console.WriteLine("ID: i101" — e-1d); 
Console.WriteLine("New Number of Employees: {0}", 
Employee4.employeeCounter ); 


} 


JE 
Input: 
Matthias Berndt 
AF643G 
15 
* 
Sample Output: 
Enter the employee's name: Matthias Berndt 
Enter the employee's ID: AF643G 
Enter the current number of employees: 15 
Name: Matthias Berndt 
ID: AF643G 
New Number of Employees: 16 
id 


OO — —À—M——————á—— —À——— ew: ni 


此 示例 说 明 : 虽然 可 以 用 另 一 个 尚未 声明 的 静态 字段 实例 化 一 个 静态 字段 ， 但 直到 
向 后 者 显 式 赋值 后 ， 才 能 确定 结果 。 


class Test 


{ 
static int x = y; 
static int y = 5; 
static void Main() 
{ 
Console.WriteLine(Test.x); 
Console.WriteLine(Test.y); 
Test.x = 99; 
Console.WriteLine(Test.x); 
} 
} 
JES 
Output: 
0 
5 
99 
oh 
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unsafe (C# 2) 


unsafe 关键 字 表 示 不 安全 上 下 文 ， 该 上 下 文 是 任何 涉及 指针 的 操作 所 必需 的 。 有 
关 更 多 信息 ， 请 参见 不 安全 代码 和 指针 (CH 编程 指南 ) 。 


可 以 在 类 型 或 成 员 的 声明 中 使 用 unsafe 修饰 符 。 因 此 ， 类 型 或 成 员 的 整个 正文 范 
围 均 被 视 为 不 安全 上 下 文 。 例 如 ， 以 下 是 用 unsafe 修饰 符 声 明 的 方法 : 


unsafe static void FastCopy(byte[] src, byte[] dst, int count 


// Unsafe context: can use pointers here. 





Se EUR 因此 指针 在 以 下 参数 列表 中 也 
可 以 使 用 : 


unsafe static void FastCopy ( byte* ps, byte* pd, int count ) (.... 
LEN; | 
还 可 以 使 用 不 安全 块 从 而 能 够 使 用 该 块 内 的 不 安全 代码 。 例 如 : 


Unsafe 


// Unsafe context: can use pointers here. 


若 要 编译 不 安全 代码 ， 必 须 指 定 unsafe 编译 器 选项 。 无 法 通过 公共 语言 运行 时 验 
证 不 安全 代码 。 


// compile with: /unsafe 


class UnsafeTest 

{ 
// Unsafe method: takes pointer to int: 
unsafe static void SquarePtrParam(int* p) 


{ 
*p *- *p; 
} 
unsafe static void Main() 
i H 
int i = 5; 
// Unsafe method: uses address-of operator (&): 
SquarePtrParam(&i); 
Console.WriteLine(i); 
} 


} 
// Output: 25 


` = i 
CH j2 Sas 
有 关 详 细 信 息 ， 请 参阅 CHGRRSGUUD. BeBe C# 语法 和 用 法 的 权威 资料 。 
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virtual (C# 27) 


virtual 关键 字 用 于 修饰 方法 、 属 性 、 索 引 器 或 事件 声明 ， 并 使 它们 可 以 在 派生 类 中 
被 重 写 。 例 如 ， 此 方法 可 被 任何 继承 它 的 类 重 写 。 
public virtual double Area() 


return x * y; 


虚拟 成 员 的 实现 可 由 派生 类 中 的 重 写成 员 更 改 。 有 关 如 何 使 用 virtual 关键 字 的 更 
多 信息 ， 请 参见 使 用 Override 和 New 关键 字 进 行 版 本 控制 (CH 编程 指南 ) 和 了 
解 何 时 使 用 Override 和 New 关键 字 (CH 编程 指南 ) o 


各 注 

调用 虚 方 法 时 ， 将 为 重 写成 员 检 查 该 对 象 的 运行 时 类 型 。 将 调用 大 部 分 派生 类 中 的 
该 重 写 成 员 ， 如 果 没 有 派生 类 重 写 该 成 员 ， 则 它 可 能 是 原始 成 员 。 

默认 情况 下 ， 方 法 是 非 虚拟 的 。 不 能 重 写 非 虚 方法 。 


virtual 修饰 符 不 能 与 static, abstract, private 或 override 修饰 符 一 起 使 用 。 下 
面 的 示例 演示 一 个 虚拟 属性 : 


class MyBaseClass 


{ 
// virtual auto-implemented property. Overrides can only 
// provide specialized behavior if they implement get and set : 
public virtual string Name { get; set; } 
// ordinary virtual property with backing field 
private int num; 
public virtual int Number 
{ 
get { return num; } 
set { num = value; } 
} 
} 
class MyDerivedClass : MyBaseClass 
{ 
private string name; 
// Override auto-implemented property with ordinary property 
// to provide specialized accessor behavior. 
public override string Name 
{ 
get 
{ 
return name; 
} 
set 
{ 
if (value != String.Empty) 
{ 
name = value; 
} 
else 
{ 
name = "Unknown"; 
} 
} 
} 
} 





除了 声明 和 调用 语法 不 同 外 ， 虚 拟 属性 的 行为 与 抽象 方法 一 样 。 


e 在 静态 属性 上 使 用 virtual 修饰 符 是 错误 的 。 


e 通过 包括 使 用 override 修饰 符 的 属性 声明 ， 可 在 派生 类 中 重 写 虚拟 继承 属 
性 。 


在 该 示例 中 ，Shape 类 包含 x、y 两 个 坐标 和 Area() 虚 方 法 。 不 同 的 形状 类 ， 如 
Circle, Cylinder 和 Sphere 继承 Shape 类 ， 并 为 每 个 图 形 计 算 表 面积 。 每 个 派生 
类 都 有 各 自 的 Area() EE E Mo 


通知 继承 的 类 Circle, Sphere 和 Cylinder 初始 化 基 类 的 所 有 使 用 构造 画 数 ， 如 以 
下 声明 所 示 。 


public Cylinder(double r, double h): base(r, h) {} 


下 面 的 过 程 通过 调用 Area) 方法 的 适当 实现 计算 并 显示 由 每 个 图 形 的 合适 区 域 ， 根 
据 与 该 方法 的 对 象 。 


class TestClass 


{ 
public class Shape 


i 
public const double PI - Math.PI; 


protected double x, y; 
public Shape() 
{ 


} 
public Shape(double x, double y) 
{ 


this.x 
this.y 


X; 
y: 


j 


public virtual double Area() 
{ 


} 


return x * y; 


} 


public class Circle : Shape 


public Circle(double r) : base(r, 0) 


{ 
j 
public override double Area() 
{ 
return PTE 
} 


} 


class Sphere : Shape 


public Sphere(double r) : base(r, 0) 
{ 
j 


public override double Area() 


1 
return 4 * PI * x * x; 
J 
Jj; 
class Cylinder : Shape 
{ 
public Cylinder(double r, double h) : base(r, h) 
{ 
} 
public override double Area() 
{ 
peturm 2 PI MOX ONUS Ph xX oy, 
J 
J 
static void Main() 
{ 
double r = 3.0, h = 5.0; 
Shape c = new Circle(r); 
Shape s = new Sphere(r); 
Shape 1 = new Cylinder(r, h); 
// Display results: 
Console.WriteLine("Area of Circle - (0:F2)", c.Area()); 
Console.WriteLine("Area of Sphere - (0:F2)", s.Area()); 
Console.WriteLine("Area of Cylinder = {0:F2}", l.Area()); 
} 
} 
Hes 
Output: 
Area of Circle = 28.27 
Area of Sphere = 113.10 
Area of Cylinder = 150.80 
of, 


[IE 
C# 语言 规范 
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volatile (Cft 参考 ) 


volatile 关键 字 指 示 一 个 字段 可 以 由 多 个 同时 执行 的 线程 修改 。 声 明 为 volatile 的 
字段 不 受 编译 器 优化 〈 假 定 由 单个 线程 访问 ) 的 限制 。 这 样 可 以 确保 该 字段 在 任何 
时 间 呈 现 的 都 是 最 新 的 值 。 


volatile 修饰 符 通 常用 于 由 多 个 线程 访问 但 不 使 用 lock 语句 对 访问 进行 序列 化 的 字 


E. 
volatile 关键 字 可 应 用 于 以 下 类 型 的 字段 : 
e 引用 类 型 。 
e 指针 类 型 (在 不 安全 的 上 下 文中 ) 。 请 注意 ， 虽 然 指针 本 身 可 以 是 可 变 的 ， 但 
S 换 旬 话说， 您 无 法 声明 “指向 可 变 对 象 的 指 
e 类 型 ， 如 sbyte, byte, short, ushort, int, uint, char, float 和 bool. 
e 具有 以 下 基 类 型 之 一 的 枚 举 类 型 : byte, sbyte, short, ushort, int 或 uint, 
e 已 知 为 引用 类 型 的 泛 型 类 型 参数 。 
e IntPtr 和 UlntPtr. 
可 变 关键 字 仅 可 应 用 于 类 或 结构 字段 。 不 能 将 局 部 变量 声明 为 volatile。 
下 面 的 示例 说 明 如 何 将 公共 字段 变量 声明 为 volatile. 
class VolatileTest 


public volatile int i; 


public void Test(int 1i) 


下 面 的 示例 演示 如 何 创建 辅助 线程 ， 并 用 它 与 主线 程 并 行 执 行 处 理 。 有 关 多 线程 处 
理 的 背景 信息 ， 请 参见 Managed Threading 和 线程 处理 (C# 和 Visual Basic) 。 


using System; 
using System.Threading; 


public class Worker 


// This method is called when the thread is started. 


public void DoWork() 


( 


while (! shouldStop) 
{ 


} 


Console.WriteLine("Worker thread: terminating gracefully." 


Console.WriteLine("Worker thread: working..."); 


public void RequestStop() 


i 


} 
// 


// 


_shouldStop = true; 


Keyword volatile is used as a hint to the compiler that thi: 
member is accessed by multiple threads. 


private volatile bool _shouldStop; 


j 


public 
t 


class WorkerThreadExample 


static void Main() 


( 


// Create the worker thread object. This does not start the 
Worker workerObject - new Worker(); 

Thread workerThread - new Thread(workerObject.DoWork); 

// Start the worker thread. 

workerThread.Start(); 

Console.WriteLine("Main thread: starting worker thread..." 


// Loop until the worker thread activates. 
while (!workerThread.IsAlive) ; 


// Put the main thread to sleep for 1 millisecond to 
// allow the worker thread to do some work. 
Thread.Sleep(1); 


// Request that the worker thread stop itself. 
workerObject.RequestStop(); 


// Use the Thread.Join method to block the current thread 
// until the object's thread terminates. 

workerThread. Join(); 

Console.WriteLine("Main thread: worker thread has terminate 


Sample output: 

Main thread: starting worker thread... 
Worker thread: working... 

Worker thread: working... 

Worker thread: working... 

Worker thread: working... 

Worker thread: working... 

Worker thread: working... 

Worker thread: terminating gracefully. 


// Main thread: worker thread has terminated. 


} 





«| 
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语句 关键 字 (C# 参考 ) 


语句 是 程序 指 舍 。 除 了 下 表 中 引用 的 主题 中 介绍 的 以 外 ， 语 句 都 是 按照 顺序 执行 


的 。 下 表 列 出 了 C# 语句 关键 字 。 有 关 不 用 任何 关键 字 表示 的 语句 的 更 多 信息 ， 请 


参见 语句 (CH 编程 指南 ) o 


类 别 
选择 语句 
和 迭代 语 名 
跳 转 语句 
异常 处 理 语句 
检查 和 未 检查 
fixed 语句 


lock 语句 


请 参阅 

CH 参考 

语句 (CH 编程 指南 ) 
CH 关键 字 


CH KRF 
if, else, switch, case 
do, for, foreach, in, while 
break, continue, default, goto, return, yield 
throw, try-catch, try-finally, try-catch-finally 
checked, unchecked 
fixed 


lock 


NQ 


选择 语句 (CH 参考 ) 


选择 语句 根据 某 个 条 件 是 否 为 true 来 将 程序 控制 权 移 交 给 特定 的 流 。 
选择 语句 中 使 用 下 列 关 键 字 : 

e if 

e else 

e switch 

e case 


e default 
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if-else (C# 5#) 


运行 的 语句 根据 Boolean Rik WA if 语句 标识 。 在 下 面 的 示例 中 ，Boolean = 
Æ result 设置 为 true， 然 后 在 让 语句 中 检查 该 变量 。 输 出 为 The condition is 
true。 


bool condition = true; 


if (condition) 


{ 

Console.WriteLine("The variable is set to true."); 
j 
else 

Console.WriteLine("The variable is set to false."); 
j 


可 以 本 主题 中 的 示例 通过 将 它们 负责 在 控件 个 app 的 Main 方法 。 
如 下 面 的 示例 所 示 ， 在 cH 中 为 话语 句 可 以 采用 两 种 形式 。 


// if-else statement 
if (condition) 


then-statement; 


j 


else 


2 


else-statement; 
// Next statement in the program. 


// if statement without an else 
if (condition) 
{ 


then-statement; 


// Next statement in the program. 


在 if-else 语句 ， 则 为 ; condition ;- $325 5& true, then-statement 运行 。 如 果 
condition 为 false，else-statement 运行 。 由 于 condition 不 能 同时 为 true 和 

false, then-statement 和 if-else 语句 的 else-statement 不 能 运行 的 两 个 。 在 then- 
statement 或 else-statement 运行 后 ， 控 件 传输 到 下 一 条 语句 在 if 语句 之 后 。 


在 没有 包括 一 个 else 语句 的 让 语 句 ， 则 为 ; condition 为 true, then-statement iz 
行 。 如 果 condition 为 false， 控 件 传输 到 下 一 条 语句 在 if 语句 之 后 。 


在 大 括号 的 then-statement 和 else-statement 可 以 包含 一 条 或 多 条 语句 (()) 中 。 对 
于 单个 语句 ， 大 括号 是 可 选 的 ， 但 建议 。 


语句 或 语句 。then-statement 和 else-statement 可 以 是 任何 类 型 ， 包 括 另 一 个 评语 
mE ER if ZO, CRE if 语句， 没有 相应 的 else 的 每 else 子 句 属于 最 后 
if。 在 下 面 的 示例 中 ， 则 为 ; m > 10 和 n>20 计算 结果 为 true，Result1 显示 。 如 
果 m>10 为 true， 但 n>20 为 false，Result2 € zn, 


// Try with m = 12 and then with m = 8. 


int m - 12; 
int n - 18; 
if (m » 10) 
if (n > 20) 
Console.WriteLine("Resulti"); 
} 
else 
Console.WriteLine("Result2"); 
} 


如 果 为 ， 则 相反 ， 您 希望 Result2 显示 (m > 10) 为 false， 您 可 以 指定 该 关联 。 使 
RAGS ERE if 语句 的 开头 和 结尾 ， 如 下 例 所 示 。 


// Try with m = 12 and then with m = 8. 
if (m > 10) 


if (n > 20) 
Console.WriteLine("Resulti"); 


} 


else 


i 
} 


Console.WriteLine("Result2"); 


在 条 件 (m > 10) 计算 为 FALSE, Result2 显示 。 
在 下 面 的 示例 中 ， 将 从 键盘 输入 字符 ， 因 此 ， 程 序 使 用 和 储 套 的 if 语句 来 确定 输入 字 


符 是 否 为 字母 字符 。 如 果 输 入 字符 是 一 个 字母 ， 程 序 检查 输入 字符 是 否 例 或 大 写 。 
消息 为 每 个 用 例 显示 。 


Console.Write("Enter a character: "); 
char c = (char)Console.Read(); 
if (Char.IsLetter(c)) 


if (Char.IsLower(c)) 


{ 
Console.WriteLine("The character is lowercase."); 
} 
else 
{ 
Console.WriteLine("The character is uppercase."); 
} 
} 
else 
{ 
Console.WriteLine("The character isn't an alphabetic character 
} 


//Sample Output: 


//Enter a character: 2 
//The character isn't an alphabetic character. 


//Enter a character: A 
//The character is uppercase. 


//Enter a character: h 
//The character is lowercase. 


E — y} 


如 下 面 的 代码 部 分 显示 ， 还 可 以 找 套 在 其 他 内 的 某 个 证 语句 块 。 该 示例 伐 套 在 两 内 
的 if 语句 其 他 块 ， 并 人 块 。 注 释 指定 的 条 件 为 true 或 false 在 每 个 块 。 





// Change the values of these variables to test the results. 


bool Conditioni = true; 
bool Condition2 - true; 
bool Condition3 - true; 
bool Condition4 - true; 


if (Condition1) 

// Conditioni is true. 
else if (Condition2) 

// Conditioni is false and Condition2 is true. 
else if (Condition3) 

if (Condition4) 


// Conditioni and Condition2 are false. Condition3 and Conc 


} 
else 
// Conditioni, Condition2, and Condition4 are false. Condit 
} 
} 
else 
// Conditioni, Condition2, and Condition3 are false. 
} 





E 一 


下 面 的 示例 确定 输入 的 字符 是 否 是 一 个 小 写字 母 、 大 写字 母 或 数字 。 如 果 所 有 三 个 
条 件 为 false， 字 符 是 字母 数字 字符 。 该 示例 演示 每 种 情况 的 一 条 消息 。 


Console.Write("Enter a character: "); 
char ch = (char)Console.Read(); 


if (Char.IsUpper(ch)) 
{ 


Console.WriteLine("The character is an uppercase letter."); 
else if (Char.IsLower(ch) ) 
{ 


Console.WriteLine("The character is a lowercase letter."); 


j 
else if (Char.IsDigit(ch)) 


{ 
Console.WriteLine("The character is a number."); 
j 
else 
{ 
Console.WriteLine("The character is not alphanumeric."); 
j 


//Sample Input and Output: 
//Enter a character: E 
//The character is an uppercase letter. 


//Enter a character: e 
//The character is a lowercase letter. 


//Enter a character: 4 
//The character is a number. 


//Enter a character: - 
//The character is not alphanumeric. 


正如 在 另 一 个 语句 块 或 块 可 以 是 任何 有 效 的 语句 ， 可 以 为 该 条 件 使 用 任何 有 效 的 布 
尔 值 表示 样式 。 您 可 以 使 用 逻辑 运算 符 (例如 &&，&，||，| 并 使 多 个 条 件 的 !。 下 面 
的 代码 演示 示例 。 


// NOT 
bool result - true; 
if (!result) 


{ 
Console.WriteLine("The condition is true (result is false)."); 
} 
else 
{ 
Console.WriteLine("The condition is false (result is true)."); 
} 
// Short-circuit AND 
int m = 9; 
qnt nz 7: 
int p - 5; 
if (m >= n && m >= p) 
{ 
Console.WriteLine("Nothing is larger than m."); 
} 


// AND and NOT 
if (m >= n && !(p > m)) 


{ 
Console.WriteLine("Nothing is larger than m."); 
j 
// Short-circuit OR 
if (m> n || m> p) 
Console.WriteLine("m isn't the smallest."); 
j 
// NOT and OR 
m= 4; 
if (!(m >= n || m >= p)) 
{ 
Console.WriteLine("Now m is the smallest."); 
} 
// Output: 


// The condition is false (result is true). 
// Nothing is larger than m. 

// Nothing is larger than m. 

// m isn't the smallest. 

// Now m is the smallest. 


有 关 详 细 信 息 ， 请 参阅 C# Eb. KSSH C# 语法 和 用 法 的 权威 资料 。 
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switch (C# 27) 


switch 话 句 是 一 个 控制 语句 ， 用 于 从 候选 列表 中 选择 一 个 要 执行 的 开关 部 分 。 


switch 语句 包含 一 个 或 多 个 开关 部 分 。 每 个 开关 部 分 包含 一 个 或 多 个 case 标签 ， 
后 接 一 个 或 多 个 语句 。 下 面 的 示例 展示 了 一 个 包含 三 个 开关 部 分 的 简单 switch 语 
句 。 每 个 开关 部 分 各 有 一 个 case 标签 (例如 case 1) 和 两 个 语句 。 


int caseSwitch = 1; 
switch (caseSwitch) 


{ 

case 1: 
Console.WriteLine("Case 1"); 
break; 

case 2: 
Console.WriteLine("Case 2"); 
break; 

default: 
Console.WriteLine("Default case"); 
break; 


备注 


每 个 case 标签 指定 一 个 常数 值 。switch 语句 会 将 控制 传输 到 case 标签 与 switch 
表达 式 的 值 (示例 中 为 caseSwitch) 相符 的 开关 部 分 。 如 果 任 何 case 标签 都 不 包 
含 匹配 值 ， 则 将 控制 传输 到 default 部 分 〈 如 果 有 ) 。 如 果 没 有 default 部 分 ， 则 
不 会 执行 任何 操作 ， 并 在 switch 语句 之 外 传输 控制 。 在 上 一 个 示例 中 ， 因 为 case 
1 与 caseSwitch 的 值 匹 配 ， 因 此 执行 第 一 个 开关 部 分 中 的 语句 。 


switch 语句 中 可 以 包含 任意 数量 的 开关 部 分 ， 每 个 开关 部 分 可 以 具有 一 个 或 多 个 
case 标签 (如 下 面 的 字符 串 case 标签 示例 中 所 示 ) 。 但 是 ， 任 何 两 个 case 标签 
不 可 包含 相同 的 常数 值 。 


执行 选 定 开关 部 分 中 的 语句 列表 时 ， 将 首先 执行 第 一 个 语句 ， 然 后 执行 整个 语句 列 
表 ， 通 常 直到 到 达 一 个 跳 转 语 名 为止， 如 break, goto case. return 或 throw. 
此 时 ， 控 件 在 switch 语句 之 外 进行 传输 或 传输 到 另 一 个 case 标签 。 


5 C++ 不 同 、C# 不 允许 从 一 个 开关 部 分 继续 执行 到 下 一 个 开关 部 分 。 下 面 的 代码 


会 导致 错误 。 


switch (caseSwitch) 


// The following switch section causes an error. 


case 1: 
Console.WriteLine("Case 1..."); 
// Add a break or other jump statement here. 
case 2: 
Console.WriteLine("... and/or Case 2"); 
break; 


CH 要 求 开关 部 分 (包括 最 后 一 个 ) 的 末尾 不 可 到 达 。 就 是 说 ， 不 同 于 其 他 一 些 语 
言 ， 代 码 不 能 落 入 下 一 个 开关 部 分 。 虽 然 此 要 求 通常 使 用 break 语句 来 满足 ， 但 以 
下 情况 同 桩 有 效 ， 因 为 它 可 以 确保 无 法 到 达 语 句 列表 的 末尾 。 


case 4: 
while (true) 
Console.WriteLine("Endless looping. . . ."); 


下 面 的 示例 演示 switch 话 句 的 要 求 和 功能 。 


class Program 


{ 
static void Main(string[] args) 
{ 
int switchExpression = 3; 
switch (switchExpression) 
{ 
// A switch section can have more than one case label. 
case 0: 
case 1: 
Console.WriteLine("Case © or 1"); 
// Most switch sections contain a jump statement, : 
// a break, goto, or return. The end of the statem: 
// must be unreachable. 
break; 
case 2: 
Console.WriteLine("Case 2"); 
break; 
// The following line causes a warning. 
Console.WriteLine("Unreachable code"); 
// 1 - 4 in the following line evaluates to 3. 
case 7 - 4: 
Console.WriteLine("Case 3"); 
break; 
// If the value of switchExpression is not 0, 1, 2, or 
// default case is executed. 
default: 
Console.WriteLine("Default case (optional)"); 
// You cannot "fall through" any switch section, ir 
// the last one. 
break; 
n 
J 
} 





在 最 后 一 个 示例 中 ， 字 符 串 变量 、str 和 字符 串 case 标签 控制 执行 流 。 


class SwitchTest 


( 


static void Main() 
{ 
Console.WriteLine("Coffee sizes: 1=small 2=medium 3=large"' 
Console.Write("Please enter your selection: "); 
string str = Console.ReadLine(); 
int cost = 0; 


// Notice the goto statements in cases 2 and 3\. The base « 
// cents is added to the additional cost for the medium anc 
switch (str) 
{ 
case "1": 
case "small": 
cost += 25; 
break; 
case "2"; 
case "medium": 
cost += 25; 
goto case "1"; 
case "3": 
case "large": 
cost += 50; 
goto case "1"; 
default: 
Console.WriteLine("Invalid selection. Please selecti 
break; 
} 
if (cost != 0) 
{ 


} 


Console.WriteLine("Thank you for your business."); 


Console.WriteLine("Please insert {0} cents.", cost); 


Sample Input: 2 


Sample Output: 

Coffee sizes: 1-small 2=medium 3=large 
Please enter your selection: 2 

Please insert 50 cents. 

Thank you for your business. 
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ANS A) (CR 参考 ) 
38 xt AIAN LA OI EET ER. ANS SU ESI G8] Ad TAIL DRE RR Rid 
行 。 除 非 遇 到 跳 转 语句 ， 否 则 这 些 语 句 将 按 顺序 执行 。 
迭代 语句 中 使 用 下 列 关 键 字 : 
e do 
e for 
e foreach 
e in 


e while 


重要 章节 


Flow Control 在 Beginning Visual C# 2010 


请 参阅 
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C# 关键 字 
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do (C4 2) 


do 语句 重复 执行 一 个 语句 或 语句 块 ， 直 到 指定 的 表达 式 计 算 为 false 值 。 循 环 体 必 
须 括 在 括号 内 ， 人 了}， 除非 它 由 单个 语句 组 成 。 在 这 种 情况 下 ， 大 括号 是 可 选 的 。 


在 下 面 的 示例 中 ， 只 要 变量 x 小 于 5，do-while 循环 语句 就 开始 执行 。 


public class TestDoWhile 


public static void Main () 


i . 
int x = 0; 
do 
{ 
Console.WriteLine(x); 
Xxtt; 
) while (x « 5); 
} 
} 
as 
Output 
0 
1 
2 
3 
4 
EX 


与 while 语句 不 同 的 是 ，do-while 循环 会 在 计算 条 件 表达 式 之 前 执行 一 次 。 
在 do-while 块 中 的 任何 点 ， 都 可 使 用 break 语句 跳出 循环 。 可 通过 使 用 continue 
语句 直接 步 入 while 表达 式 评 估 语 句 。 如 果 while 表达 式 计 算 结 果 为 true， 则 继续 


执行 循环 中 的 第 一 个 语句 。 如 果 表 达 式 计算 结果 为 false， 则 会 继续 从 do-while 循 
环 后 的 第 一 个 A BA) LAT 


do-while 循环 还 可 以 通过 goto, return 3$ throw 语句 退出 。 

C# 2 BAG 

有 关 详 细 信 息 Ny 请 参阅 CZ i EAD. 该 语 言 规范 JE 是 CH 语法 和 用 法 的 权威 资 料 。 
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for (C4 2) 

使 用 for 循环 ， 可 以 反复 运行 语句 或 语句 块 ， 直 到 指定 的 表达 式 计 算 为 false. 3X 
种 循环 是 用 于 循环 访问 数组 以 及 您 事先 知道 的 其 他 应 用 程序 多 少 次 希望 此 循环 。 
在 下 面 的 示例 中 ，i 的 值 被 宇 入 控制 台 。 并 按 1 递增 循环 的 每 次 迭代 时 。 


class ForLoopTest 
static void Main() 
for (int i = 1; i <= 5; i++) 


Console.WriteLine(i); 


j 

j 

y 
Output 
1 

2 

3 

4 

5 

n 


前 面 示例 中 的 for 语句 执行 以 下 操作 。 


1. Ei, np i 的 初始 值 建立 的 。 此 步骤 仅 发 生 一 次 ， 无 论 多 少 次 此 循环 。 您 可 
以 将 此 初始 化 ， 当 发 生 循环 处 理 的 外 部 。 


2. 若 要 计算 该 条 件 (i <= 5)，i 的 值 与 5. 比较 。 
o 如 果 i 小 于 或 等 于 5， 该 条 件 的 计算 结果 为 true， 因 此 ， 以 下 操作 。 
ij， 在 循环 主体 的 Console.WriteLine 语句 演示 i 的 值 。 
ii. i 的 值 由 1. 增加 。 
iii， 循环 回 起 点 第 2 步 再 次 计算 该 条 件 。 
o 如 果 i 大 于 5， 该 条 件 的 计算 结果 为 false， 因 此 ， 您 退出 循环 。 
请 注意 ， 因 此 ， 如 果 i 的 原始 值 大 于 5， 循 环 体 哪怕 一 次 不 会 运行 。 


每 个 for 语句 定义 初始 值 设 定 项 、 条 件 和 迭代 器 部 分 。 这 些 部 分 通常 多 少 次 此 循 
环 。 


for (initializer; condition; iterator) 
body 


部 分 提供 了 以 下 用 途 。 


e 初始 值 设 定 项 部 分 设置 初始 条 件 。 在 任 一 次 运行 的 此 部 分 的 语句 ， 则 ， 在 进入 
循环 之 前 。 该 部 分 只 能 包含 下 面 两 个 选项 。 


o 本 地 循环 变量 的 声明 和 初始 化 ， 作 为 第 一 个 示例 显示 (inti = 1)。 该 变量 是 
本 地 到 循环 ， 不 能 从 循环 外 部 访问 。 


o 雾 个 或 多 个 语句 expressons 从 以 下 列表 ， 以 过 号 分 隔 。 
a 分 配 语句 
" 方法 的 调用 
向 或 后 级 增 量 表达 式 作 为 前 级 ， 例 如 ++i 或 i++ 
a 向 或 后 级 减 量 表达 式 作为 前 级 ， 例 如 --i 或 i-- 
m 对象 的 使 用 创建 的 new 
m 等 待 表达 式 
e. 条 件 部 分 包含 计算 确定 的 布尔 表达 式 循环 是 否 应 该 退出 或 应 再 次 运行 。 


e 和 迭代 器 节 定 义 了 什么 在 循环 体 中 的 每 个 迭代 之 后 发 生 。 秋 代 器 节 包 含 需 个 或 多 
个 下 列 语句 表达 式 ， 喜 号 分 隔 ): 


o 分 配 语句 

o 方法 的 调用 

o 向 或 后 级 增 量 表达 式 作 为 前 级 ， 例 如 ++i 或 it+ 
o 向 或 后 级 减 量 表达 式 作 为 前 级 ， 例 如 --i 或 i-- 
o 对 象 的 使 用 创建 的 new 

o 等 待 表达 式 


循环 体 包 括 语 句 、 一 个 空 的 语句 或 语句 块 ， 则 通过 将 需 个 或 多 个 语句 创建 在 大 
括号 。 


使 用 中 断 关键 字 ， 则 可 能 发 生 for 循环 ， 使 用 继续 关键 字 ， 也 可 以 单 步 执行 
到 下 一 个 迭代 。 使 用 导航 、 返 回 或 引发 语句 ， 还 可 以 退出 所 有 循环 。 


本 主题 中 的 第 一 个 示例 显示 最 典型 的 for 循环 ， 做 出 部 分 的 下 列 选 择 。 
。 该 初始 值 设 定 项 声明 并 初始 化 本 地 循环 变量 ，i， 维 护 循环 的 迭代 计数 。 
e 状态 检查 循环 变量 的 值 已 知 的 最 终 值 ，5. 的 。 


e ANA RIBUS, i++, LAC tA RIAK. 


下 面 的 示例 阐释 若干 不 太 常 见 选择 : 将 值 赋 给 初始 值 设 定 项 部 分 的 外 部 循环 变量 ， 
对 初始 值 设 定 项 和 迭代 器 部 分 的 Console.WriteLine 方法 和 更 改 两 个 变量 的 值 在 迭 
代 器 部 分 。 


static void Main() 


( . . 
int 1; 
int j - 10; 
for (i = 0, Console.WriteLine("Start: {0}",1); i < j; i++, j-- 


// Body of the loop. 


// Start: 0 


Hu Hn gp out IN 
O1 O - CO oO 


i 
i 
i 
i 





定义 一 个 for 语句 的 任何 表达 式 都 是 可 选 的 。 例 如 ， 下 面 的 语句 创建 无 限 循环 。 


fon, ) 
{ 
i oar 
} 
CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参 阅 CH 语 言 规范 。 该 语 & AG Jb D 是 CH 35 法 和 用 法 的 权威 资料 。 
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C# 关键 字 

foreach, in (C£ 参考 ) 
for 语句 (C++) 
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迭代 语句 (Ct 参考 ) 


for (CH 参考 ) 758 


foreach, in (C4 参考 ) 


foreach 语句 对 实现 System.Collections.IEnumerable 或 
System.Collections.Generic.IEnumerable<T> 接口 的 数组 或 对 象 集合 中 的 每 个 元 素 
重复 一 组 伐 入 式 语 句 。 foreach 语句 用 于 循环 访问 集合 ， 以 获取 您 需要 的 信息 ， 但 
不 能 用 于 在 源 集 合 中 添加 或 移 除 项 ， 否 则 可 能 产生 不 可 预知 的 副作用 。 如 果 需 要 在 
源 集合 中 添加 或 移 除 项 ， 请 使 用 for 循环 。 


嵌入 语句 为 数组 或 集合 中 的 每 个 元 素 继 续 执 行 。 当 为 集合 中 的 所 有 元 素 完成 迭代 
后 ， 控 制 传递 给 foreach 块 之 后 的 下 一 个 语句 。 


可 以 在 foreach 块 的 任何 点 使 用 break 关键 字 跳 出 循环 ， 或 使 用 continue 关键 字 
进入 循环 的 下 一 轮 迭 代 。 


foreach 循环 还 可 以 通过 goto, return 或 throw 语句 退出 。 
有 关 foreach 关键 字 和 代码 示例 的 更 多 信息 ， 请 参见 下 面 的 主题 : 
对 数组 使 用 foreach (C# 编程 指南 ) 
如 何 : 使 用 foreach 访问 集合 类 (CH 编程 指南 ) 
以 下 代码 显示 了 三 个 示例 : 
e 显示 整数 数组 内 容 的 典型 的 foreach 循环 
e. 执行 相同 操作 的 for 循环 
e. 维护 数组 中 的 元 素数 计数 的 foreach 循环 


class ForEachTest 


i 


static void Main(string[] args) 


{ 
int[] fibarray = new int[] { 8, 1, 1, 2, 3, 5, 8, 13 }; 
foreach (int element in fibarray) 


{ 
} 


System.Console.WriteLine(); 


System.Console.WriteLine(element); 


// Compare the previous loop to a similar for loop. 
for (int i = 0; i « fibarray.Length; i++) 


{ 
} 


System.Console.WriteLine(); 


System.Console.WriteLine(fibarray[i]); 


// You can maintain a count of the elements in the collect: 
int count - 0; 


foreach (int element in fibarray) 


{ 
count += 1; 
System.Console.WriteLine("Element #{0}: {1}", count, e: 


} 


System.Console.WriteLine("Number of elements in the array: 


// Output: 


SS 
5s 
FoOUWNREF © 


SS 
SS 
FOoOOmWNRFR © 


3 


// Element #1: 
// Element #2: 
// Element #3: 
// Element #4: 
// Element #5: 
// Element #6: 
// Element #7: 
// Element #8: 13 

// Number of elements in the array: 8 


AOWNREF © 
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迭代 语句 (CR BA) 
for (C# 参考 ) 


foreach, in (CZ 参考 ) 761 


while (C4 2) 


while 语句 执行 一 个 语句 或 语句 块 ， 直 到 指定 的 表达 式 计 算 为 false. 


class WhileTest 


{ 
static void Main() 
{ H 

int n = 1; 

while (n < 6) 

{ 
Console.WriteLine("Current value of n is {0}", n); 
n++: 

} 

} 

} 

el 
Output: 
Current value of n is 1 
Current value of n is 2 
Current value of n is 3 
Current value of n is 4 
Current value of n is 5 

A 


class WhileTest2 
{ 
static void Main() 
{ 
We N ss 
while (n++ < 6) 
{ 


Console.WriteLine("Current value of n is {0}", n); 


} 

7/58 

Output: 

Current value of 
Current value of 
Current value of 
Current value of 
Current value of 
a 


is 
is 
is 
is 
is 


She ee e] 
OO OI 上 上 wm 


由 于 while 表达 式 的 测试 在 每 次 执行 循环 前 发 生 ， 因 此 while 循环 执行 需 次 或 更 多 
次 。 这 与 执行 一 次 或 多 次 的 do 循环 不 同 。 

当 break, goto, return 或 throw 语句 将 控制 权 转 移 到 while 循环 之 外 时 ， 可 以 终 
止 该 循环 。 若 要 将 控制 权 传递 给 下 一 次 迭代 但 不 退出 循环 ， 请 使 用 continue 语句。 
请 注意 ， 在 上 面 三 个 示例 中 ， 根 据 int n 递增 的 位 置 的 不 同 ， 输 出 也 不 同 。 在 下 面 
的 示例 中 不 生成 输出 。 


class WhileTest3 


{ 
static void Main() 
{ 
int n = 5; 
while (++n < 6) 
Console.WriteLine("Current value of n is {0}", n); 
j 
j 


C# 语言 规范 


有 关 详 细 信息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

C# 编程 指南 

CH 关键 字 

While 语句 (C++) 
迭代 语句 (CR 参考 ) 


跳 转 语句 (CH BA) 
使 用 跳 转 语句 执行 分 支 ， 该 语句 导致 立即 传递 程序 控制 。 跳 转 语句 中 使 用 下 列 关 键 
ce 

e break 

e continue 

e goto 

e return 


e throw 


请 参阅 

CHES 

Cft 编程 指南 

C# 关键 字 

语句 关键 字 (C# 参考 ) 


break (C# 2) 


break 语句 用 于 终止 最 近 的 封闭 循环 或 它 所 在 的 switch 语句 。 控 制 传递 给 终止 语句 
后 面 的 语句 (如果 有 的 话 ) o 
在 此 示例 中 ， 条 件 语句 包含 一 个 应 从 1 计数 到 100 的 计数 器 ; 但 break i$ 4] TE it 
数 器 计数 到 4 后 终止 了 循环 。 


class BreakTest 


{ 
static void Main() 
{ 
for (int i = 1; i <= 100; i++) 
if (i == 5) 
break; 
} 
Console.WriteLine(i); 
} 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
JL 
Output: 
1 
2 
3 
4 
“7 


在 此 示例 中 ，break 语句 用 于 中 断 内 层 启 套 循环 ， 并 将 控制 权 返 回 给 外 层 循环 。 


class BreakInNestedLoops 


{ 
static void Main(string[] args) 
{ 
int[] numbers = { ©, 1, 2, 3, 4, 5, 6, 7, 8, 9 Y: 
Chiari; Lebvercs =f Sar Di C4. “d*, wet gp germ 


// Outer loop 
for (int x = 0; x « numbers.Length; x++) 


Console.WriteLine("num = (0)", numbers[x]); 


// Inner loop 
for (int y = 0; y < letters.Length; y++) 


{ 
if (y == x) 
// Return control to outer loop 
break; 
} 
Console.write(" (0) ", letters[y]); 
} 


Console.WriteLine(); 


j 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


} 

} 

Js 

* Output: 
num = O 
num = 1 
a 
num = 2 
a b 
num = 3 
a b c 
num = 4 
a b c d 
num = 5 
a b c d e 
num = 6 
a b ce d e 1f 
num = 7 
a b c d e f 'g 
num = 8 
a b c d ef g h 
num = 9 
a b c d e f g h i 
wh 





下 面 的 示例 演示 break 在 switch 语句 中 的 用 法 。 


class Switch 


static void Main() 


t 
{ 
} 
} 
Vix 


Console.Write("Enter your selection (1, 2, or 3): 


string s = Console.ReadLine(); 
int n - Int32.Parse(s); 


switch (n) 


{ 


case 1: 


Console.WriteLine("Current value is {0}", 


break; 
case 2: 


Console.WriteLine("Current value is {0}", 


break; 
case 3: 


Console.WriteLine("Current value is {0}", 


break; 
default: 


B 


Console.WriteLine("Sorry, invalid selection."); 


break; 


j 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


Sample Input: 1 


Sample Output: 
Enter your selection (1, 2, or 3): 
Current value is 1 


A 


如 果 输 入 了 4， 则 输出 为 : 


Enter your selection (1, 2, or 3): 


Sorry, 


CH i 


Zuma 


invalid selection. 


++ 


有 关 详 细 信 息 ， 请 参阅 C# i$ EA. 该 语言 规范 是 CZ ié 知 法 和 用 法 的 权威 资 
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CH 参考 

C# 编程 指南 

C# 关键 字 

switch (CH 参考 ) 
跳 转 语句 (CH BS) 
和 迭代 语句 (C# BS) 


break (C£ 参考 ) 


768 


continue (C# 参考 ) 


continue 语句 将 控制 传递 到 封闭 while, . 7; SX X zn B foreach 语句 下 一 次 迭代 。 


在 本 示例 中 ， 计 数 器 最 初 是 从 1 到 10 进行 计数 。 通 过 使 用 该 表达 式 (i < 9) 一 起 的 
continue 语句 ， 在 continue 和 for 主体 结束 的 语句 跳 过 。 


class ContinueTest 


{ 
static void Main() 
for (int i = 1; i <= 10; i++) 
if (i < 9) 
1 . 
continue; 
} 
Console.WriteLine(i); 
} 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
Vi 
Output: 
9 
10 
LA 


d Xitimiíam.GbeNCA4AGEREGGUUD. KSSH C# 语法 和 用 法 的 权威 资料 。 
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跳 转 语句 (CH 参考 ) 


continue (C£ 参考 ) 770 


goto (C4 参考 ) 


goto 话 句 将 程序 控制 直接 传递 给 标记 语句 。 


goto 的 一 个 通常 用 法 是 将 控制 传递 给 特定 的 switch-case 标签 或 switch 语句 中 的 
默认 标签 。 


goto 语句 还 用 于 跳出 深 庶 套 循环 。 
下 面 的 示例 演示 了 goto 在 switch 语句 中 的 使 用 。 


class SwitchTest 


( 


static void Main() 
{ 
Console.WriteLine("Coffee sizes: 1=Small 2=Medium 3-Large'"' 
Console.Write("Please enter your selection: "); 
string s = Console.ReadLine(); 
int n = int.Parse(s); 
int cost = 0; 
switch (n) 
{ 
case 1: 
cost += 25; 
break; 
case 2: 
cost += 25; 
goto case 1; 
case 3: 
cost += 50; 
goto case 1; 
default: 
Console.WriteLine("Invalid selection."); 
break; 


if (cost !- 0) 
{ 


} 


Console.WriteLine("Thank you for your business."); 


Console.WriteLine("Please insert (0) cents.", cost); 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


j 
Vas 
Sample Input: 2 


Sample Output: 

Coffee sizes: 1=Small 2=Medium 3=Large 
Please enter your selection: 2 

Please insert 50 cents. 

Thank you for your business. 

v 





下 面 的 示例 演示 了 使 用 goto 跳出 谋 套 循环 。 


public class GotoTest1 
t 


static void Main() 


int x = 200, y = 4; 
int count = 0; 
string[,] array = new string[x, y]; 


// Initialize the array: 
for (int i = 0; i < x; i++) 


for (int j = 0; j < y; j++) 
array[i, j] = (++count).ToString(); 


// Read input: 
Console.Write("Enter the number to search for: "); 


// Input a string: 
string myNumber - Console.ReadLine(); 


// Search: 
for (int i = 0; i < x; i++) 
{ 
for (int j = 0; j < y; j++) 
{ 
if (array[i, j].Equals(myNumber)) 
goto Found; 
} 
} 


} 


Console.WriteLine("The number {0} was not found.", myNumbet 
goto Finish; 


Found: 
Console.WriteLine("The number {0} is found.", myNumber); 


Finish: 
Console.WriteLine("End of search."); 


// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


} 
J 
Sample Input: 44 


Sample Output 

Enter the number to search for: 44 
The number 44 is found. 

End of search. 

SY 
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请 参阅 

CH 参考 

C# 编程 指南 

C# 关键 字 


goto 语句 (C++) 
跳 转 语句 (CH SA) 


return (C£ 参考 ) 
return 语句 终止 它 出 现在 其 中 的 方法 的 执行 并 将 控制 返回 给 调用 方法 。 它 还 可 以 返 
回 一 个 可 选 值 。 如 果 方 法 为 void 类 型 ， 则 可 以 省 略 return 语句 。 


如 果 return 语句 位 于 try 块 中 ， 则 将 在 控制 流 返 回 到 调用 方法 之 前 执行 finally + 
(如 果 存 在 ) 。 


在 下 面 的 示例 中 ， 方 法 A() 以 double 值 的 形式 返回 变量 Area, 
class ReturnTest 
{ 


static double CalculateArea(int r) 


double area = r * r * Math.PI; 
return area; 


J 

static void Main() 

{ 
int radius = 5; 
double result = CalculateArea(radius); 
Console.WriteLine("The area is {0:0.00}", result); 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 

} 


// Output: The area is 78.54 


CH 32 BASE 


有 关 详 细 信 息 ， 请 参阅 CH 语 B. 该 语言 规范 ILB 是 C# 语 法 和 用 法 的 权威 资 料 。 
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return (C£ BA) 776 


异 剃 处 理 语句 (CH SA) 
CH 为 处 理 在 程序 执行 期 间 可 能 出 现 的 反常 情况 MERE) HABER. KE 
异常 由 正常 控制 流 之 外 的 代码 处 理 。 
本 节 说 明 下 列 异常 处 理 主题 : 
e throw 
e try-catch 
e try-finally 
e try-catch-finally 


请 参阅 

CH 参考 

CH 编程 指南 

C# 关键 字 

语句 关键 字 〈C# BS) 
异常 和 异常 处 理 (C# 编程 指南 ) 


throw (C 2) 

throw 语句 用 于 发 出 程序 执行 期 间 出 现 反常 情况 (异常 ) 的 信号 。 

各 注 

引发 的 异常 是 一 个 对 象 ， 其 类 派生 自 System.Exception， 如 以 下 示例 所 示 。 


class MyException : System.Exception {} 
V 
throw new MyException(); 


i835, throw 语句 与 try-catch x try-finally 语句 结合 使 用 。 可 在 catch 块 中 使 用 
语句 以 重新 引发 已 由 catch 块 捕获 的 异常 。 在 这 种 情况 下 ， 语句 不 采用 异常 操作 
数 。 有 关 更 多 信息 和 示例 ， 请 参见 try-catch (C£ 参考 ) 和 如 何 : 显 式 引发 异常 。 


此 示例 演示 如 何 使 用 throw 语句 引发 异常 。 


public class ThrowTest2 


{ 
static int GetNumber(int index) 
{ 
int[] nums = { 300, 600, 900 }; 
if (index > nums.Length) 
{ 
throw new IndexOutOfRangeException(); 
} 
return nums[index]; 
static void Main() 
{ 
int result = GetNumber (3); 
} 
} 
Vas 
Output: 
The System.IndexOutOfRangeException exception occurs. 
2y 


代码 示例 
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请 参见 try-catch (CH 27) 和 如 何 : 显 式 引发 异常 中 的 示例 。 


有 关 详 细 信息 ， 请 参阅 C# 语言 规 了 范 。 该 语言 规 范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

CH 参考 

C# 编程 指南 

try-catch (C# 参考 ) 

C++ 中 的 try, catch 和 throw 语句 
C# 关键 字 

异常 处 理 语句 (C# 参考 ) 

如 何 : 显 式 引 发 异常 


throw (CH 参考 ) 
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try-catch (Ct 2) 


Try-catch 语句 包含 一 个 后 接 一 个 或 多 个 catch 子 句 的 try 块 ， 这 些 子 句 指定 不 同 
异常 的 处 理 程序 。 


备注 


引发 异常 时 ， 公 共 语 言 运行 时 (CLR) 查找 处 理 此 异常 的 catch 语句。 如 果 当 前 正在 
执行 的 方法 不 包含 此 类 catch 块 ， 则 CLR 查看 调用 了 当前 方法 的 方法 ， 并 以 此 类 
推 通 万 调 用 堆栈 。 如 果 未 找到 任何 catch 块 ， 则 CLR 向 用 户 显 示 一 条 未 处 理 的 异 
常 消息 ， 并 停止 执行 程序 。 

try 块 包含 可 能 导致 异常 的 受 保护 的 代码 。 将 执行 此 块 ， 直 至 引发 异常 或 其 成 功 完 
成 。 例 如 ， 强 制 转 换 null 对 象 的 以 下 党 斌 会 引发 NullReferenceException 异常 : 


object o2 - null; 
try 
{ 


j 


int i2 - (int)o2; // Error 


尽管 可 以 不 带 参 数 使 用 catch 子 句 来 捕获 任何 类 型 的 异常 ， 但 不 推荐 这 种 用 法 。 一 
般 情况 下 ， 只 应 捕获 你 知道 如 何 从 其 恢复 的 异常 。 因 此 ， 应 始终 指定 派生 自 
System.Exception 的 对 象 参 数 ， 例 如 : 


catch (InvalidCastException e) 


j 


可 以 使 用 同一 try-catch 语句 中 的 多 个 特定 catch 子 句 。 在 这 种 情况 下 ，catch F 
句 的 顺序 很 重要 ， 因 为 catch 子 句 是 按 顺序 检查 的 。 在 使 用 更 笼统 的 子 句 之 前 获取 
特定 性 更 强 的 异常 。 如 果 捕 获 块 的 排序 使 得 永 不 会 达到 之 后 的 块 ， 则 编译 器 将 产生 
错误 。 

筛选 想 要 义理 的 异常 的 一 种 方式 是 使 用 catch 参数 。 也 可 以 使 用 谓词 表达 式 进一步 
检查 该 异常 以 决定 是 否 要 对 其 进行 处 理 。 如 果 谓 词 表 达 式 返回 false， 则 继续 搜索 处 
理 程序 。 


Catch (ArgumentException e) if (e.ParamName == %...” 


j 


异常 第 选 器 要 优 于 捕获 和 重新 引发 (如 下 所 述 ) ， 因 为 筛选 器 将 保留 堆栈 不 受 损 
坏 。 如 果 之 后 的 处 理 程序 转 储 堆栈 ， 可 以 查看 到 异常 的 原始 来 源 ， 而 不 只 是 重新 引 
发 它 的 最 后 一 个 人 位置。 异常 筛选 器 表达 式 的 一 个 常见 用 途 是 日 志 记 录 。 可 以 创建 一 
个 始终 返回 false 并 输出 到 日 志 的 谓词 男 数 ， 而 且 可 以 在 异常 通过 时 进行 记录 ， 无 
需 处 理 并 重新 引发 它们 。 

可 在 catch 块 中 使 用 throw 语句 以 重新 引发 已 由 catch 语句 捕获 的 异常 。 下 面 的 示 
lM IOException 异常 提取 源 信息 ， 然 后 向 父 方 法 引发 异常 。 


catch (FileNotFoundException e) 
// FileNotFoundExceptions are handled here. 


catch (IOException e) 


{ 
// Extract some information from this exception, and then 
// throw it to the parent method. 
if (e.Source != null) 
Console.WriteLine("IOException source: {0}", e.Source); 
throw; 
} 


你 可 以 捕获 一 个 异常 而 引发 一 个 不 同 的 异常 。 执 行 此 操作 时 ， 请 指定 作为 内 部 异常 
捕获 的 异常 ， 如 以 下 示例 所 示 。 
catch (InvalidCastException e) 


// Perform some action here, and then throw a new exception. 
throw new YourCustomException("Put your error message here.", « 





当 指 定 的 条 件 为 true 时 ， 你 还 可 以 重新 引发 异常 ， 如 以 下 示例 所 示 。 


catch (InvalidCastException e) 


if (e.Data -- null) 


throw; 
j 
else 

// Take some action. 
} 


从 try 块 内 ， 公 初始 化 在 其 中 声明 的 变量 。 否 则 ， 在 完成 执行 块 之 前 ， 可 能 会 出 现 
异常 。 例 如 ， 在 下 面 的 代码 示例 中 ， 变 量 n 在 try 块 内 部 初始 化 。 尝 试 在 Write(n) 
语句 的 try 块 外 部 使 用 此 变量 将 生成 编译 器 错误 。 


static void Main() 


i H 
int n; 
try 
// Do not initialize this variable here. 
i = 122. 
J; 
catch 
{ 
// Error: Use of unassigned local variable 'n'. 
Console.Write(n); 
} 


有 关 catch 的 详细 信息 ， 请 参阅 try-catch-finally。 


ROA EAN RS 


异步 方法 由 async 修饰 符 标 记 ， 通 常 包含 一 个 或 多 个 await 表达 式 或 语句 。await 
表达 式 将 await 运算 符 应 用 于 Task 或 Task<TResult>。 


当 控 件 到 达 异 步 方法 中 的 await 时 ， 将 挂 起 方法 中 的 进度 ， 直 到 所 等 待 的 任务 完 
成 。 任 务 完 成 后 ， 可 以 在 方法 中 恢复 执行 。 有 关 详 细 信 息 ， 请 参阅 使 用 Async 和 
Await 的 异步 编程 (C# 和 Visual Basic) 和 异步 程序 中 的 控制 流 (C# 和 Visual 

Basic) 。 


应 用 了 await 的 完成 任务 可 能 由 于 返回 此 任务 的 方法 中 存在 未 处 理 的 异常 而 处 于 错 
误 状 态 。 等 待 该 任务 引发 异常 。 如 果 取 消 了 返回 任务 的 异步 进程 ， 此 任务 最 后 也 可 
能 为 已 取消 状态 。 等 待 已 取消 的 任务 引发 OperationCanceledException。 有 关 如 
何 取消 异步 进程 的 详细 信息 ， 请 参阅 微调 异步 应 用 程序 (C# 和 Visual Basic) 。 


若 要 捕获 异常 ， 请 在 try 块 中 等 待 任务 并 在 关联 的 catch 块 中 捕获 异常 。 相 关 示 
例 ， 请 参见 “示例 "一 节 。 


任务 可 能 处 于 错误 状态 ， 因 为 等 待 的 异步 方法 中 发 生 了 多 个 异常 。 例 如 ， 任 务 可 能 
是 对 Task.WhenAll 调用 的 结果 。 当 等 待 此 类 任务 时 ， 仅 捕捉 到 其 中 一 个 异常 ， 而 
且 你 无 法 预测 将 会 捕获 到 哪个 异常 。 相 关 示 例 ， 请 参见 “示例 "一 节 。 


在 下 面 的 示例 中 ，try 块 包含 对 可 能 引发 异常 的 ProcessString 方法 的 调用 。 catch 
子 句 包 含 只 在 屏幕 上 显示 一 条 消息 的 异常 处 理 程序 。 当 从 MyMethod 内 部 调用 
throw 语句 时 ， 系 统 将 查找 catch 语句 并 显示 消息 Exception caught. 


在 下 面 
若 要 捕 


class TryFinallyTest 
static void ProcessString(string s) 


if (s == null) 


{ 
throw new ArgumentNullException(); 
j 
j 
static void Main() 
{ 
string s = null; // For demonstration purposes. 
try 
{ 
ProcessString(s); 
j 
catch (Exception e) 
{ 
Console.WriteLine("{0} Exception caught.", e); 
j 
j 
VEX 
Output: 


System.ArgumentNullException: Value cannot be null. 
at TryFinallyTest.Main() Exception caught. 
RE A 


的 示例 中 ， 使 用 了 两 个 catch 块 ， 并 捕获 到 最 先 出 现 的 最 具体 的 异常 。 
获 最 不 具体 的 异常 ， 你 可 以 将 ProcessString 中 的 throw 语句 替换 为 以 下 


句 : throw new Exception()。 


如 果 将 最 不 具体 的 catch 块 置 于 示例 中 第 一 个 ， 将 显示 以 下 错误 消息 : A previous 
catch clause already catches all exceptions of this or a super type 
('System.Exception"), 


i 


class ThrowTest3 


{ 
static void ProcessString(string s) 
if (s == null) 
{ 
throw new ArgumentNullException(); 
j 
j 
static void Main() 
f 
try 
{ 
string s = null; 
ProcessString(s); 
// Most specific: 
catch (ArgumentNullException e) 
Console.WriteLine("{0} First exception caught.", e); 
// Least specific: 
catch (Exception e) 
Console.WriteLine("[0) Second exception caught.", e); 
j 
} 
} 
Vix 
Output: 
System.ArgumentNullException: Value cannot be null. 
at Test.ThrowTest3.ProcessString(String s) ... First exception cat 
wre 





下 面 的 示例 阅 释 异步 方法 的 异常 处 理 。 若 要 捕获 异步 任务 引发 的 异常 ， 将 await 表 
达 式 置 于 try 块 中 ， 并 在 catch 块 中 捕获 该 异常 。 


将 演示 异常 处 理 的 示例 中 的 Throw New Exception 行 取消 注释 。 任务 的 IsFaulted 
属性 设置 为 True， 任 务 的 Exception.InnerException 属性 设置 为 异常 ， 并 在 
catch 块 中 捕获 该 异常 。 


取消 注释 throw new OperationCancelledException 行 以 演示 在 取消 异步 进程 时 发 
生 的 情况 。 任 务 的 IsCanceled 属性 设置 为 true， 并 在 catch 块 中 捕获 异常 。 在 某 
些 不 适用 于 此 示例 的 情况 下 ， 任 务 的 IsFaulted 属性 设置 为 true H IsCanceled 设 
置 为 false, 





public async Task DoSomethingAsync() 
{ 


Task<string> theTask = DelayAsync(); 


try 
{ 


string result = await theTask; 
Debug.WriteLine("Result: " + result); 


catch (Exception ex) 


{ 


} 
Debug.WriteLine("Task IsCanceled: " + theTask.IsCanceled); 


Debug.WriteLine("Task IsFaulted: " + theTask.IsFaulted); 
if (theTask.Exception != null) 


{ 


Debug.WriteLine("Exception Message: " + ex.Message); 


Debug.WriteLine("Task Exception Message: " 
+ theTask.Exception.Message); 
Debug.WriteLine("Task Inner Exception Message: 
+ theTask.Exception.InnerException.Message); 


} 


private async Task<string> DelayAsync() 


{ 
await Task.Delay(100); 


// Uncomment each of the following lines to 
// demonstrate exception handling. 


//throw new OperationCanceledException("canceled"); 
//throw new Exception("Something happened."); 
return "Done"; 


j 


// Output when no exception is thrown in the awaited method: 
// Result: Done 

// Task IsCanceled: False 

// Task IsFaulted: False 


// Output when an Exception is thrown in the awaited method: 
// Exception Message: Something happened. 

// | Task IsCanceled: False 

// | Task IsFaulted: True 

// Task Exception Message: One or more errors occurred. 

M Task Inner Exception Message: Something happened. 


// Output when a OperationCanceledException or TaskCanceledExceptic 
// is thrown in the awaited method: 

Mi Exception Message: canceled 

// | Task IsCanceled: True 

// | Task IsFaulted: False 











下 面 的 示例 阐释 了 在 多 个 任务 可 能 导致 多 个 异常 的 情况 中 的 异常 处 理 。 try 块 等 待 
由 Task.WhenAll 的 调用 返回 的 任务 。 应 用 了 WhenAll 的 三 个 任务 完成 后 ， 该 任务 
完成 。 


三 个 任务 中 的 每 一 个 都 会 导致 异常 。 catch 块 循环 访问 异常 ， 这 些 异常 位 于 由 
Task.WhenAll 返回 的 任务 的 Exception.InnerExceptions 属性 中 。 


public async Task DoMultipleAsync() 


{ 
Task theTaski = ExcAsync(info: "First Task"); 
Task theTask2 - ExcAsync(info: "Second Task"); 
Task theTask3 - ExcAsync(info: "Third Task"); 
Task allTasks = Task.WhenAll(theTaski, theTask2, theTask3); 
try 
{ 
await allTasks; 
} 
catch (Exception ex) 
{ 
Debug.WriteLine("Exception: " + ex.Message); 
Debug.WriteLine("Task IsFaulted: " + allTasks.IsFaulted); 
foreach (var inEx in allTasks.Exception.InnerExceptions) 
{ 
Debug.WriteLine("Task Inner Exception: " + inEx.Message 
} 
} 
} 
private async Task ExcAsync(string info) 
{ 
await Task.Delay(100); 
throw new Exception("Error-" + info); 
} 
// Output: 


// Exception: Error-First Task 

// | Task IsFaulted: True 

// Task Inner Exception: Error-First Task 

// Task Inner Exception: Error-Second Task 
// Task Inner Exception: Error-Third Task 





有 关 详 细 信 息 ， 请 参阅 C# Eb. Ke SMe C# 语法 和 用 法 的 权威 资料 。 
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try-finally (C4 2) 


使 用 finally 块 ， 可 以 清理 在 Try 中 分 配 的 任何 资源 ， 而 且 ， 即 使 在 try 块 中 发 生 异 
常 ， 您 也 可 以 运行 代码 。 通常 ， 控 件 离开 try 语句 之 后 ，finally 的 语句 会 阻止 运 
行 。 正常 执行 中 break, continue, goto 或 return 语句 的 执行 ， 或 对 try 语句 外 
部 异常 的 传播 ， 可 能 会 导致 发 生 控 件 转换 。 


已 处 理 的 异常 中 会 确保 运行 关联 的 finally 块 。 但 是 ， 如 果 异 常 示 得 到 处 理 ， 则 
finally 块 的 执行 取决 于 如 何 触发 异常 展开 操作 。 此 操作 又 取决 于 计算 机 是 如 何 设 
置 的 。 有 关 更 多 信息 ， 请 参见 Unhandled Exception Processing in the CLR (CLR 
中 的 未 经 处 理 的 异常 处 理 ) 。 


通常 ， 当 未 经 处 理 的 异常 中 止 应 用 程序 时 ，finally 块 是 否 运行 并 不 重要 。 但 是 ， 
如 果 您 拥有 的 finally 块 中 的 语句 必须 在 该 环境 下 运行 ， 则 一 个 解决 方案 是 将 catch 
块 添加 到 try-finally 语句 中 。 或 者 ， 可 以 捕获 可 能 是 在 调用 堆栈 更 上 方 的 try- 
finally 语句 的 try 块 中 引发 的 异常 。 即 可 以 捕获 调用 了 包含 try-finally 语句 的 方法 
中 的 、 或 调用 了 该 方法 的 方法 中 的 、 或 调用 堆栈 中 任何 方法 中 的 异常 。 如 果 未 捕获 
异常 ， 则 finally 块 的 执行 取决 于 操作 系统 是 否 选择 触发 异常 展开 操作 。 


示例 


在 下 面 的 示例 中 ， 无 效 转换 语句 导致 System.InvalidCastException 异常 。 异常 未 
处 理 。 


public class ThrowTestA 


( 


static void Main() 


1 


int i = 123; 
string s = "Some string"; 
object obj = s; 


// Invalid conversion; obj contains a string, 


// The following statement is not run. 


not a nur 


Console.WriteLine("WriteLine at the end of the try bloc 


// To run the program in Visual Studio, type CTRL+F5\. 


// click Cancel in the error dialog. 


Console.WriteLine("\nExecution of the finally block aft 
"error depends on how the exception unwind operatic 


try 
{ 
i = (int)obj; 
} 
finally 
{ 
Console.WriteLine("i = {0}", i); 
} 
Output: 


Execution of the finally block after an unhandled 
error depends on how the exception unwind operation is trigg 
i = 123 


Unhandled Exception: System.InvalidCastException: Specified 





在 下 面 的 示例 中 ，TryCast 方法 中 的 异常 在 延伸 调用 堆栈 的 方法 中 被 捕获 。 


public class ThrowTestB 


( 


static void Main() 


1 


try 
{ 


// TryCast produces an unhandled exception. 


TryCast(); 


catch (Exception ex) 


{ 


// Catch the exception that is unhandled in TryCast. 


Console.WriteLine 


("Catching the {0} exception triggers the finally | 


ex.GetType()); 


// Restore the original unhandled exception. You might 
// know what exception to expect, or how to handle it, 


// it on. 
throw; 
} 
} 
public static void TryCast() 
{ 
int i = 123; 
string s = "Some string"; 
object obj = s; 
try 
{ 
// Invalid conversion; obj contains a string, not a nur 
i = (int)obj; 
// The following statement is not run. 
Console.WriteLine("WriteLine at the end of the try bloc 
} 
finally 
{ 
// Report that the finally block is run, and show that 
// i has not been changed. 
Console.WriteLine("\nIn the finally block in TryCast, 
} 
// Output: 


// In the finally block in TryCast, i = 123. 
// Catching the System.InvalidCastException exception triggers 


// Unhandled Exception: System.InvalidCastException: Specified 





& X finally 的 更 多 信息 ， 请 参见 try-catch-finallys 
CH 还 包含 使 用 语句 ， 该 语句 可 为 Disposable 对 象 提供 类 似 功 能 的 方法 语法 。 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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try-catch-finally (Ct 参考 ) 


catch 和 finally 一 起 使 用 的 常见 方式 是 : 在 try 块 中 获取 并 使 用 资源 ， 在 catch + 
中 处 理 异常 情况 ， 并 在 finally 块 中 释放 资源 。 

有 关 重 新 引发 异常 的 更 多 信息 和 示例 ， 请 参见 try-catch 和 “引发 异常 。 有 关 finally 
的 更 多 信息 ， 请 参见 尝试 最 终 块 。 


public class EHClass 


{ 
void ReadFile(int index) 
{ 
// To run this code, substitute a valid path from your loc: 
string path = @"c:\users\public\test.txt"; 
System.IO.StreamReader file = new System.IO.StreamReader(p: 
char[] buffer = new char[10]; 
try 
file.ReadBlock(buffer, index, buffer.Length); 
catch (System.IO.IOException e) 
Console.WriteLine("Error reading from {0}. Message = {: 
} 
finally 
if (file != null) 
file.Close(); 
} 
} 
// Do something with buffer... 
} 
} 





C# 语言 规范 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
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Checked 和 Unchecked (CZ 2) 


CH 语句 既 可 以 在 已 检查 的 上 下 文中 执行 ， 也 可 以 在 未 检查 的 上 下 文中 执行 。 在 已 
检查 的 上 下 文中 ， 算 法 浴 出 引发 异常 。 在 未 检查 的 上 下 文中 ， 算 法 洽 出 被 忽略 并 且 
结果 被 截断 。 


e checked 指定 已 检查 的 上 下 文 。 
e unchecked 指定 未 检查 的 上 下 文 。 


如 果 既 未 指定 checked 也 未 指定 unchecked， 则 默认 上 下 文 取 决 于 外 部 因素 (如 
编译 器 选项 ) 。 


下 列 操作 受 浴 出 检查 的 影响 : 
e 表达 式 在 整 型 上 使 用 下 列 预 定义 运算 符 : 
ees (TX) onem 
。 整 型 问 的 显 式 数字 转换 。 


/checked 编译 器 选项 使 你 可 以 为 checked 或 unchecked 关键 字 范 围 内 的 所 有 非 
显 式 整 型 算术 语句 指定 已 检查 或 未 检查 的 上 下 文 。 
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checked (CÓ 24) 


checked 关键 字 用 于 对 整 型 算术 运算 和 转换 显 式 启 用 浴 出 检查 。 


默认 情况 下 ， 如 果 表 达 式 仅 包含 常数 值 ， 且 产生 的 值 在 目标 类 型 范围 之 外 ， 则 它 
导致 编译 器 错误 。 如 果 表 达 式 包含 一 个 或 多 个 非常 数值 ， 则 编译 器 不 检测 渝 出 。 = 
下 面 的 示例 中 ， 计 算 赋 给 i2 的 表达 式 不 会 导致 编译 器 错误 。 


// The following example causes compiler error CS0220 because 2147: 
// is the maximum value for integers. 
//int i1 = 2147483647 + 10; 


// The following example, which includes variable ten, does not cai 
// a compiler error. 

int ten - 10; 

int i2 = 2147483647 + ten; 


// By default, the overflow in the previous statement also does 
// not cause a run-time exception. The following line displays 
// -2,147,483,639 as the sum of 2,147,483,647 and 10. 
Console.WriteLine(i2); 





AUE F, EMT N HARE REPRRARA EAM, RERAAAS| AS 
异常 。 上 面 的 示例 显示 -2,147,483,639 作为 两 个 正 整数 之 和 。 


可 以 通过 编译 器 选项 、 环 境 配置 或 使 用 checked 关键 字 来 启用 浴 出 检查 。 下 面 的 
示例 演示 如 何 使 用 checked 表达 式 或 checked 块 ， 在 运 1 由 前 面 的 求 和 计 
算 导 致 的 浴 出 。 两 个 示例 都 引发 浴 出 异常 。 


// If the previous sum is attempted in a checked environment, an 
// OverflowException error is raised. 


// Checked expression. 
Console.WriteLine(checked(2147483647 + ten)); 


// Checked block. 
checked 


{ 
int 13 = 2147483647 + ten; 
Console.WriteLine(i3); 


Bl x] Mi 
可 以 使 用 unchecked 关键 字 阻 止 浴 出 检查 。 
此 示例 演示 如 何 使 用 checked 启用 运行 时 浴 出 检查 。 


class OverFlowTest 


{ 


// Set maxIntValue to the maximum value for integers. 
static int maxIntValue - 2147483647; 


// Using a checked expression. 
static int CheckedMethod() 
{ . 

int z = 0; 

try 


// The following line raises an exception because it is 
z = checked(maxIntValue + 10); 


} 


catch (System.OverflowException e) 


// The following line displays information about the ei 
Console.WriteLine("CHECKED and CAUGHT: ^" + e.ToStringi 
} 
// The value of z is still 0. 
return Z; 


} 


// Using an unchecked expression. 
static int UncheckedMethod() 


{ 
int z = 0; 
try 
// The following calculation is unchecked and will not 
// raise an exception. 
z = maxIntValue + 10; 
} 
catch (System.OverflowException e) 
// The following line will not be executed. 
Console.WriteLine("UNCHECKED and CAUGHT: " + e.ToStrir 
} 
// Because of the undetected overflow, the sum of 21474836: 
// returned as -2147483639. 
return Z; 
} 
static void Main() 
{ 
Console.WriteLine("NnCHECKED output value is: {0}", 
CheckedMethod( )); 
Console.WriteLine("UNCHECKED output value is: {0}", 
UncheckedMethod( )); 
} 
Vs 


Output: 


CHECKED and CAUGHT: System.OverflowException: Arithmetic operat 


in an overflow. 
at ConsoleApplicationi.OverFlowTest.CheckedMethod() 


CHECKED output value is: 0 
UNCHECKED output value is: -2147483639 
uA 
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unchecked (C4 2) 


unchecked 关键 字 用 于 取消 整 型 算术 运算 和 转换 的 渝 出 检查 。 


在 未 检查 的 上 下 文中 ， 如 果 表 达 式 产生 的 值 在 目标 类 型 范围 之 外 ， 并 不 会 标记 浴 
出 。 例 如 ， 下 例 中 的 计算 在 unchecked 块 或 表达 式 中 执行 ， 因 此 将 忽略 结果 对 于 
整数 而 言 过 大 这 一 事实 ， 并 会 对 int1 赋予 值 -2,147,483,639。 


unchecked 


{ 
} 


int1 = unchecked(ConstantMax + 10); 


inti = 2147483647 + 10; 


如 果 移 除 unchecked 环境 ， 则 发 生 编译 错误 。 因 为 表达 式 的 各 个 项 都 是 常数 ， 所 
以 可 以 在 编译 时 检测 到 浴 出 。 


默认 情况 下 ， 在 编译 时 和 运行 时 不 检查 包含 非常 数 项 的 表达 式 。 有 关 启 用 检查 环境 
的 信息 ， 请 参见 checked (C# 参考 ) 。 


因为 渝 出 检查 比较 耗 时 ， 所 以 当 无 渝 出 危险 时 ， 使 用 不 检查 的 代码 可 以 提高 性 能 。 
但 是 ， 如 果 可 能 发 生 浴 出 ， 则 应 使 用 检查 环境 。 


此 示例 演示 如 何 使 用 unchecked 关键 字 。 


class UncheckedDemo 
{ 
static void Main(string[] args) 
{ 
// int.MaxValue is 2,147,483,647. 
const int ConstantMax = int.MaxValue; 
int int1; 
int int2; 
int variableMax = 2147483647; 


// The following statements are checked by default at comp: 
// compile. 

//int1 = 2147483647 + 10; 

//int1 = ConstantMax + 10; 


// To enable the assignments to inti to compile and run, p: 
// an unchecked block or expression. The following statemer 
// run. 

unchecked 


{ 
int1 = 2147483647 + 10; 


int1 = unchecked(ConstantMax + 10); 


// The sum of 2,147,483,647 and 10 is displayed as -2,147,: 
Console.WriteLine(int1); 


// The following statement is unchecked by default at comp: 
// time because the expression contains the variable varial 
// overflow but the overflow is not detected. The statement 
int2 = variableMax + 10; 


// Again, the sum of 2,147,483,647 and 10 is displayed as - 
Console.WriteLine(int2); 


// To catch the overflow in the assignment to int2 at run 1 
// declaration in a checked block or expression. The follov 
// statements compile but raise an overflow exception at ri 
checked 


i 


} 
//int2 = checked(variableMax + 10); 


//int2 = variableMax + 10; 


// Unchecked sections frequently are used to break out of : 
// environment in order to improve performance in a portior 
// that is not expected to raise overflow exceptions. 
checked 


{ 
// Code that might cause overflow should be executed ir 
// environment. 
unchecked 
// This section is appropriate for code that you a! 
// will not result in overflow, and for which perf: 
// a priority. 
// Additional checked code here. 
} 
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fixed 324) (Cf 参考 ) 


fixed 语句 禁止 垃圾 回收 器 重 定位 可 移动 的 变量 。 fixed 语句 只 在 不 安全 的 上 下 文 
中 是 允许 的 。 Fixed 还 可 用 于 创建 固定 大 小 缓冲 区 。 


fixed 语句 设置 指向 托管 变量 的 指针 ， 并 在 执行 该 语句 期 间 “ 固 定 ?此 变量 。 如 果 没 有 
fixed 话 句 ， 则 指向 可 移动 托管 变量 的 指针 的 作用 很 小 ， 因 为 垃圾 回收 可 能 不 可 预 
知 地 重 定位 变量 。C# 编译 器 只 人 允许 在 fixed 语句 中 分 配 指向 托管 变量 的 指针 。 


unsafe static void TestMethod() 


{ 


// Assume that the following class exists. 
//class Point 

//{ 

// public int x; 

Ee public int y; 


// Nariable pt is a managed variable, subject to garbage collec 
Point pt = new Point(); 


// Using fixed allows the address of pt members to be taken, 
// and "pins" pt so that it is not relocated. 


fixed (int* p = &pt.x) 





可 通过 使 用 数组 、 字 符 串 、 大 小 固定 的 缓冲 区 或 变量 地 址 初始 化 指针 。 以 下 示例 演 
示 可 变 地 址 、 数 组 和 字符 串 的 用 法 。 关 于 固定 大 小 缓冲 器 的 更 多 信息 ， 请 参见 固定 
大 小 的 缓冲 区 (CH 编程 指南 ) o 


static unsafe void Test2() 


{ 
Point point = new Point(); 
double[] arr = { ©, 1.5, 2.3, 3.4, 4.0, 5.9 }; 
string str = "Hello World"; 


// The following two assignments are equivalent. Each assigns 1 
// of the first element in array arr to pointer p. 


// You can initialize a pointer by using an array. 
fixed (double* p = arr) ( /*...*/ 3 


// You can initialize a pointer by using the address of a vari: 
fixed (double* p = &arr[0]) ( /*...*/ } 


// The following assignment initializes p by using a string. 
fixed (char^ p = str) { /*...*/ } 


// The following assignment is not valid, because str[0] is a « 
// which is a value, not a variable. 
//fixed (char* p = &str[0]) { /*...*/ } 
// You can initialize a pointer by using the address of a vari: 
// as point =X or arr[5]. 
fixed (int* p1 = &point.x) 

fixed (double* p2 = &arr[5]) 


// Do something with p1 and p2. 





只 要 指针 的 类 型 相同 ， 就 可 以 初始 化 多 个 指针 。 


fixed (byte* ps = srcarray, pd = dstarray) {...} 


要 初始 化 不 同类 型 的 指针 ， 只 需 谋 套 fixed 语句 ， 如 下 面 的 示例 所 示 。 


fixed (int* p1 = &point.x) 
fixed (double* p2 - &arr[5]) 


// Do something with p1 and p2. 


执行 完 语句 中 的 代码 后 ， 任 何 固定 变量 都 被 解除 固定 并 受 垃 圾 回收 的 制约 。 因 此 ， 
不 要 指向 fixed 语句 之 外 的 那些 变量 。 


8 注意 
无 法 修改 在 fixed 语句 中 初始 化 的 指针 。 


在 不 安全 模式 中 ， 可 以 在 堆栈 上 分 配 内 存 。 堆 栈 不 受 垃 圾 回收 的 制约 ， 因 此 不 需要 
被 锁定 。 有 关 更 多 信息 ， 请 参见 stackalloc。 


class Point 


{ 
public int x, y; 
} 
class FixedTest2 
{ 
// Unsafe method: takes a pointer to an int. 
unsafe static void SquarePtrParam (int* p) 
{ 
*p *= Pe 
} 
unsafe static void Main() 
{ 
Point pt = new Point(); 
pt.x = 5; 
pt.y = 6; 
// Pin pt in place: 
fixed (int* p = &pt.x) 
{ 
SquarePtrParam (p); 
// pt now unpinned. 
Console.WriteLine ("{0} {1}", pt.x, pt.y); 
} 
} 
ifs 
Output: 
25 6 
5 
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“锁定 ”语句 (CH 参考 ) 


lock 关键 字 将 语句 块 标记 为 临界 区 ， 方 法 是 获取 给 定 对 象 的 互 斥 锁 ， 执 行 语句 ， 然 
后 释放 该 锁 。 下 面 的 示例 包含 一 个 lock 语句 。 


class Account 


{ 
decimal balance; 
private Object thisLock - new Object(); 
public void Withdraw(decimal amount) 
{ 
lock (thisLock) 
if (amount > balance) 
throw new Exception("Insufficient funds"); 
} 
balance -= amount; 
} 
} 
} 


有 关 更 多 信息 ， 请 参见 线程 同步 (C# 和 Visual Basic) 。 


备注 


lock 关键 字 可 确保 当 一 个 线程 位 于 代码 的 临界 区 时 ， 另 一 个 线程 不 会 进入 该 临界 
区 。 如 果 其 他 线程 党 试 进入 锁定 的 代码 ， 则 它 将 一 直 等 待 〈 即 被 阻止 ) ， 直 到 该 对 
象 被 释放 。 


线程 处 理 (C# 和 Visual Basic) 这 节 讨 论 了 线程 处 理 。 


lock 关键 字 在 块 的 开始 处 调用 Enter， 而 在 块 的 结尾 处 调用 Exit 
ThreadlInterruptedException 引发 ， 如 果 Interrupt 中 断 等 待 输入 lock 语句 的 线 


程 。 


通常 ， 应 避免 锁定 public 类 型 ， 否 则 实例 将 超出 代码 的 控制 范围 。 常 见 的 结构 
lock (this), lock (typeof (MyType)) 和 lock ("myLock") 违反 此 准则 : 


。 如 果实 例 可 以 被 公共 访问 ， 将 出 现 lock (this) 问题 。 
e 如 果 MyType 可 以 被 公共 访问 ， 将 出 现 lock (typeof (MyType)) 问题 。 


e 由 于 进程 中 使 用 同一 字符 串 的 任何 其 他 代码 都 将 共享 同一 个 锁 ， 所 以 出 现 
lock("myLock") 问题 。 


最 佳 做 法 是 定义 private 对 象 来 锁定 , X private static 对 象 变量 来 保护 所 有 实例 所 
共有 的 数据 。 


在 lock 语句 的 正文 不 能 使 用 等 符 关键 字 。 
下 面 演 示 在 C# 中 使 用 未 锁定 的 线程 的 简单 示例 。 


//using System.Threading; 
class ThreadTest 


public void RunMe() 
{ 


} 


static void Main() 


Console.WriteLine("RunMe called"); 


ThreadTest b = new ThreadTest(); 
Thread t - new Thread(b.RunMe); 
t.Start(); 


p 
// Output: RunMe called 


下 例 使 用 线程 和 lock, RE lock 语 名 存在， 语句 块 就 是 临界 区 并 且 balance 永远 
会 是 负数 。 
// using System.Threading; 


class Account 


{ 
private Object thisLock = new Object(); 
int balance; 
Random r = new Random(); 


public Account(int initial) 


balance = initial; 


} 


int Withdraw(int amount) 

{ 
// This condition never is true unless the lock statement 
// is commented out. 
if (balance < 0) 


throw new Exception("Negative Balance"); 


// Comment out the next line to see the effect of leaving « 
// the lock keyword. 
lock (thisLock) 


if (balance »- amount) 


{ 
Console.WriteLine("Balance before Withdrawal R 
Console.WriteLine("Amount to Withdraw e 
balance = balance - amount; 
Console.WriteLine("Balance after Withdrawal E 
return amount; 
} 
else 
{ 
return 0; // transaction rejected 
} 
} 
} 
public void DoTransactions() 
{ 
for (int i = 0; i < 100; i++) 
Withdraw(r.Next(1, 100)); 
} 
} 
} 
class Test 
{ 
static void Main() 
{ 
Thread[] threads = new Thread[10]; 
Account acc = new Account(1000); 
for (int i = 0; i < 10; i++) 
Thread t = new Thread(new ThreadStart(acc.DoTransactior 
threads[i] = t; 
} 
for (int i = 0; i < 10; i++) 
threads[i].Start(); 
} 
} 
} 
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方法 参数 (C# 参考 ) 


如 果 在 为 方法 声明 参数 时 未 使 用 ref 或 out， 则 该 参数 可 以 具有 关联 的 值 。 可 以 在 方 
法 中 更 改 该 值 ， 但 当 控制 传递 回调 用 过 程 时 ， 不 会 保留 更 改 的 值 。 通 过 使 用 方法 参 
数 关键 字 ， 可 以 更 改 这 种 行为 。 


本 节 描 述 声 明 方 法 参数 时 可 以 使 用 的 关键 字 : 
e params 
e ref 


e Out 


Án 
CHES 

C# 编程 指南 
CH 关键 字 


params (C4 参考 ) 


使 用 params 关键 字 可 以 指定 采用 数目 可 变 的 参数 的 方法 参数 。 


可 以 发 送 参数 声明 中 所 指定 类 型 的 逗号 分 隔 的 参数 列表 或 指定 类 型 的 参数 数组 。 还 
可 以 不 发 送 参数 。 如 果 未 发 送 任何 参数 ， 则 params 列表 的 长 度 为 需 。 


在 方法 声明 中 的 params 关键 字 之 后 不 允许 任何 其 他 人 参数， 并且 在 方法 声明 中 只 人 允 
许 一 个 params 关键 字 。 


下 面 的 示例 演示 可 向 params 参数 发 送 参数 的 各 种 方法 。 


public class MyClass 


( 


public static void UseParams(params int[] list) 


j 


for (int i = 0; i < list.Length; i++) 


Console.Write(list[i] + " "); 


} 


Console.WriteLine(); 


public static void UseParams2(params object[] list) 


{ 


} 


for (int i = 6; i < list.Length; i++) 


i 
} 


Console.WriteLine(); 


Console.wWrite(laist[i] + " "55 


static void Main() 


( 


// You can send a comma-separated list of arguments of the 
// specified type. 

UseParams(1, 2, 3, 4); 

UseParams2(1, 'a', "test"); 


// A params parameter accepts zero or more arguments. 
// The following calling statement displays only a blank 1: 
UseParams2(); 


// An array argument can be passed, as long as the array 
// type matches the parameter type of the method being cal. 
int[] myIntArray = (5, 6, 7, 8, 9 Y; 
UseParams(myIntArray); 


object[] myObjArray = (2, 'b', "test", "again" }; 
UseParams2(myObjArray); 


// The following call causes a compiler error because the ( 
// array cannot be converted into an integer array. 
//UseParams(myObjArray); 


// The following call does not cause an error, but the ent: 
// integer array becomes the first element of the params a! 
UseParams2(myIntArray); 


} 
} 
Hs 
Output 
1234 
1 a test 
5167819 
2 b test again 
System. Int32[] 
a 
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ref (C# BS) 


ref 关键 字 通 过 引用 (而 非 值 ) 传递 参数 。 通 过 引用 传递 的 效果 是 ， 对 所 调用 方法 
中 的 参数 进 和 例如 ， 如 果 调 用 方 传递 本 地 变量 表 
达 式 或 数组 元 素 访问 表达 式 ， 所 调用 方法 会 将 对 象 蔡 换 为 ref 参数 引用 的 对 象 ， 然 
后 调用 方 的 本 地 变量 或 数组 元 素 将 开始 引用 新 对 象 。 


EF 注意 

不 要 混淆 通过 引用 传递 的 概念 与 引用 类 型 的 概念 。 这 两 种 概念 是 不 同 的 。 无 论 
方法 参数 是 值 类 型 还 是 引用 类 型 ， 均 可 由 ref 修改 。 当 通过 引用 传递 时 ， 不 会 对 
值 类 型 装 箱 。 


人 ref 参数 ， 方 法 定义 和 调用 方法 均 必 须 显 式 使 用 ref 关键 字 ， 如 下 面 的 示 
列 所 示 。 


class RefExample 


{ 
static void Method(ref int i) 
{ 
// Rest the mouse pointer over i to verify that it is an itr 
// The following statement would cause a compiler error if 
// were boxed as an object. 
ap S cb ons Ale 
} 
static void Main() 
{ 
int val = 1; 
Method(ref val); 
Console.WriteLine(val); 
// Output: 45 
} 
} 





hes 到 ref 形 参 的 实 参 必 须 先 经 过 初始 化 ， 然 后 才能 传递 。 这 与 out 形 参 不 同 ， 在 
递 之 前 ， 不 需要 显 式 初始 化 该 形 参 的 实 参 。 有 关 详 细 人 信息， 请 参阅 out 


类 的 成 员 不 能 有 具有 仅 在 ref 和 out 方面 不 同 的 签名 。 如 果 类 型 的 两 个 成 员 之 间 的 唯 
一 区 别 在 于 其 中 一 个 具有 ref 参数 ， 而 另 一 个 具有 out 参数 ， 则 会 发 生 编 译 错 误 。 
例如 ， 以 下 代码 将 不 会 编译 。 


class CS0663 Example 


// Compiler error CS0663: "Cannot define overloaded 
// methods that differ only on ref and out". 

public void SampleMethod(out int i) { } 

public void SampleMethod(ref int i) { } 


但 是 ， 当 一 个 方法 具有 ref 或 out 参数 ， 另 一 个 方法 具有 值 参数 时 ， 则 可 以 完成 重 
载 ， 如 下 面 的 示例 所 示 。 
class RefOverloadExample 


public void SampleMethod(int i) { } 
public void SampleMethod(ref int i) { } 


在 其 他 要 求 签名 匹配 的 情况 下 (如 隐藏 或 重 写 ) ，ref 和 out 是 签名 的 一 部 分 ， 相 
互 之 间 不 匹配 。 


属性 不 是 变量 。 它 们 是 方法 ， 不 能 传递 到 ref 参数 。 

有 关 如 何 传递 数组 的 信息 ， 请 参阅 使 用 ref 和 out 传递 数组 (CH 编程 指南 ) o 

你 不 能 将 ref 和 out 关键 字 用 于 以 下 几 种 方法 : 

e 异步 方法 ， 通 过 使 用 async 修饰 符 定义 。 

e REDA, afi yield return 或 yield break 语句 。 

前 面 的 示例 演示 当 通 过 引用 传递 值 类 型 时 会 发 生 什 么 情况 。 你 还 可 以 使 用 ref 关键 
字 传 递 引 用 类 型 。 通 过 引用 传递 引用 类 型 可 以 使 所 调用 方法 将 调用 方法 中 的 对 象 蔡 
换 为 引用 参数 所 引用 的 对 象 。 对 象 的 存储 位 置 按 引 用 参数 的 值 传递 到 方法 。 如 果 更 
改 参 数 存 储 位 置 中 的 值 〈 以 指向 新 对 象 ) ， 你 还 可 以 将 存储 位 置 更 改 为 调用 方 所 引 


用 的 位 置 。 下 面 的 示例 将 引用 类 型 的 实例 作为 ref 参数 传递 。 有 关 如 何 通过 值 和 引 
用 传递 引用 类 型 的 详细 信息 ， 请 参阅 传递 引用 类 型 参数 (CH 编程 指南 ) o 


class RefExample2 


{ 
static void ChangeByReference(ref Product itemRef ) 
{ 
// The following line changes the address that is stored ir 
// parameter itemRef. Because itemRef is a ref parameter, 1 
// address that is stored in variable item in Main also is 
itemRef = new Product("Stapler", 99999); 
// You can change the value of one of the properties of 
// itemRef. The change happens to item in Main as well. 
itemRef.ItemID = 12345; 
} 
static void Main() 
{ 
// Declare an instance of Product and display its initial \ 
Product item = new Product("Fasteners", 54321); 
System.Console.WriteLine("Original values in Main. Name: . 
item.ItemName, item.ItemID); 
// Send item to ChangeByReference as a ref argument. 
ChangeByReference(ref item); 
System.Console.WriteLine("Back in Main. Name: {0}, ID: {1 
item.ItemName, item.ItemID); 
} 
} 
class Product 
{ 
public Product(string name, int newID) 
{ 
ItemName = name; 
ItemID = newID; 
} 
public string ItemName { get; set; } 
public int ItemID { get; set; } 
} 
// Output: 


//Original values in Main. Name: Fasteners, ID: 54321 


//Back in Main. Name: Stapler, ID: 12345 
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请 参阅 

C# 参考 

C# 编程 指南 

传递 参数 (CH 编程 指南 ) 
方法 参数 (CH 参考 ) 

CH 关键 字 


ref (C# 参考 ) 


815 


out (C£ 2) 


你 可 以 在 两 个 上 下 文 《 每 个 都 是 指 同 详细 信息 的 链接 ) 中 使 用 out 上 下 文 关键 字 作 
为 参数 修饰 符 ， 或 在 接口 和 委托 中 使 用 泛 型 类 型 参数 声明 。 本 主题 讨论 参数 修饰 
符 ， 但 你 可 以 参 间 其 他 主题 了 解 关于 泛 型 类 型 参数 声明 的 入 息 


out 关键 字 通 过 引用 传递 参数 。 这 与 ref 关键 字 相似 ， 只 不 过 ref 要 求 在 传递 之 前 初 
oa Sn 方法 定义 和 调用 方法 均 必 须 显 式 使 用 out 关键 字 。 
class OutExample 
static void Method(out int i) 
ica 
static void Main() 
int value; 


Method(out value); 
// value is now 44 


尽管 作为 out 参数 传递 的 变量 无 需 在 传递 之 前 初始 化 ， 调 用 方法 仍 要 求 在 方法 返回 
之 前 赋值 。 


尽管 ref 和 out 关键 字 会 导致 不 同 的 运行 时 行为 ， 它 们 并 不 被 视 为 编译 时 方法 签名 
的 一 部 分 。 因 此 ， 如 果 唯 一 的 不 同 是 一 个 方法 采用 ref 参数 ， 而 另 一 个 方法 采用 
out 参数 ， 则 无 法 重 载 这 两 个 方法 。 例 如 ， 以 下 代码 将 不 会 编译 : 


class CS0663 Example 


{ 
// Compiler error CS0663: "Cannot define overloaded 
// methods that differ only on ref and out". 
public void SampleMethod(out int i) { } 
public void SampleMethod(ref int i) { } 
} 


ok a a 
BR, 


class OutOverloadExample 


public void SampleMethod(int i) { } 
public void SampleMethod(out int i) { i = 5; ) 


属性 不 是 变量 ， 因 此 不 能 作为 out 参数 传递 。 

有 关 传 递 数组 的 信息 ， 请 参阅 使 用 ref 和 out 传递 数组 (CH 编程 指南 ) 。 
你 不 能 将 ref 和 out 关键 字 用 于 以 下 几 种 方法 : 

e 异步 方法 ， 通 过 使 用 async 修饰 符 定义 。 

e 迭代 器 方法 ， 包 括 yield return 或 yield break 语句 。 


如 果 希 望 方法 返回 多 个 值 ， 可 以 声明 out 方法 。 下 面 的 示例 使 用 out 返回 具有 单个 
方法 调用 的 三 个 变量 。 注 意 ， 第 三 个 参数 赋 null 值 。 这 使 得 方法 可 以 有 选择 地 返回 
值 。 


class OutReturnExample 


{ 
static void Method(out int i, out string s1, out string s2) 
{ . 
1 = 44; 
si = "I've been returned"; 
s2 = null; 
} 
static void Main() 
{ 
int value; 
string stri. str2; 
Method(out value, out stri, out str2); 
// value is now 44 
// stri is now "I've been returned" 
// Str2 is (still) null; 
} 
} 
请 参阅 


out 参数 修饰 符 (CH 参考 ) 


out 关键 字 会 导致 参数 通过 引用 来 传递 。 这 和 与 ref 关键 字 类 似 ， 不 同 之 处 在 于 ref 要 
求 变量 必须 在 传递 之 前 进行 初始 化 。 若 要 使 用 out 参数 ， 方 法 定义 和 调用 方法 都 必 
须 显 式 使 用 out 关键 字 。 例 如 : 


class OutExample 


{ 
static void Method(out int i) 
i H 
1 = 44; 
static void Main() 
{ 
int value; 
Method(out value); 
// value is now 44 
} 
} 


尽管 作为 out 参数 传递 的 变量 不 必 在 传递 之 前 进行 初始 化 ， 但 被 调用 的 方法 需要 在 
返回 之 前 赋 一 个 值 。 


尽管 ref 和 out 关键 字 会 导致 不 同 的 运行 时 行为 ， 但 在 编译 时 并 不 会 将 它们 视 为 方 
法 签名 的 一 部 分 。 因 此 ， 如 果 两 个 方法 唯一 的 区 别 是 : 一 个 接受 ref 参数 ， 另 一 个 
接受 out 参数 ， 则 无 法 重 载 这 两 个 方法 。 例 如 ， 不 会 编译 下 面 的 代码 : 


class CS0663 Example 


// Compiler error CS0663: "Cannot define overloaded 
// methods that differ only on ref and out". 

public void SampleMethod(out int i) { } 

public void SampleMethod(ref int i) { } 


但 是 ， 如 果 一 个 方法 采用 ref 或 out 参数 ， 而 另 一 个 方法 不 采用 这 两 类 参数 ， 则 可 
以 进行 重 载 ， 如 下 所 示 : 


class OutOverloadExample 


{ 
public void SampleMethod(int i) { } 
public void SampleMethod(out int i) { i = 5; } 


属性 不 是 变量 ， 因 此 不 能 作为 out 参数 传递 。 


有 关 传 递 数组 的 信息 ， 请 参见 使 用 ref 和 out 传递 数组 (CH 编程 指南 ) o 
不 能 为 以 下 方法 使 用 ref 和 out 关键 字 : 

e 异步 方法 ， 或 者 使 用 async 修饰 符 ， 定 义 。 

e 和 迭代 器 方法 ， 包 括 一 个 将 返回 或 yield break 语句 。 


当 希 望 方法 返回 多 个 值 时 ， 声 明 out 方法 很 有 用 。 下 面 的 示例 使 用 out 在 一 次 方法 
调用 中 返回 三 个 变量 。 请 注意 ， 第 三 个 参数 所 赋 的 值 为 Null。 这 样 使 方法 可 以 有 选 
择 地 返回 值 。 


class OutReturnExample 


{ 
static void Method(out int i, out string s1, out string s2) 
i . 
1 = 44 
s1 = "I've been returned" 
s2 = null; 
static void Main() 
t 
int value; 
string stri str2; 
Method(out value, out stri, out str2); 
// value is now 44 
// stri is now "I've been returned" 
// str2 is (still) null; 
J 
} 
五 三 <+ 
CH i4 543 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规 沁 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


$$ 
C# 参考 
C# 编程 指南 
C# 关键 字 
方法 参数 (CH BE) 


命名 空间 关键 字 (CH BA) 


本 节 描 述 与 using 命名 空间 关联 的 关键 字 和 运算 符 : 
zu 


CH 参考 

C# 编程 指南 

C# 关键 字 

命名 空间 (CH 编程 指南 ) 


命名 空间 (CH 参考 ) 


namespace 关键 字 用 于 声明 一 组 相关 对 象 的 大 小 。 可 以 使 用 命名 空间 组 织 代码 元 
素 和 创建 全 局 唯一 类 型 。 


namespace SampleNamespace 

i class SampleClass { } 
interface SampleInterface { } 
struct SampleStruct { } 
enum SampleEnum { a, b } 


delegate void SampleDelegate(int i); 


namespace SampleNamespace.Nested 


{ 
} 


class SampleClass2 { } 


备注 
在 一 个 命名 空间 中 ， 可 以 声明 一 个 或 多 个 下 列 类 型 : 

e 另 一 个 命名 空间 

e class 

e interface 

e struct 

e enum 

e Delegate 一 委托 
无 论 您 是 否 在 C# 源 文 件 中 显 式 声明 了 命名 空间 ， 编 译 器 都 会 添加 一 个 默认 的 命名 
空间 。 该 未 命名 的 命名 空间 (有 时 称 为 全 局 命名 空间 ) 存在 于 每 一 个 文件 中 。 全 局 
命名 空间 中 的 任何 标识 符 都 可 用 于 命名 的 命名 空间 中 。 


命名 空间 隐 式 具有 公共 访问 权 ， 并 且 这 是 不 可 修改 的 。 有 关 可 以 分 配给 命名 空间 中 
的 元 素 的 访问 修饰 符 的 讨论 ， 请 参见 访问 修饰 符 (C# 参考 ) 。 


在 两 个 或 更 多 的 声明 中 定义 一 个 命名 空间 是 可 以 的 。 例 如 ， 下 面 的 示例 将 两 个 类 定 
义 为 MyCompany 命名 空间 的 一 部 分 : 


namespace MyCompany.Proj1 


{ 
class MyClass 
{ 
J 
J 
namespace MyCompany.Proj1 
{ 
class MyClassi 
t 
} 
} 


下 面 的 示例 显示 了 如 何在 谋 套 的 命名 空间 中 调用 静态 方法 。 


namespace SomeNameSpace 


{ 
public class MyClass 
{ 
static void Main() 
Nested.NestedNameSpaceClass.SayHello(); 
} 
} 


// a nested namespace 
namespace Nested 


public class NestedNameSpaceClass 


public static void SayHello() 
{ 


} 


Console.WriteLine("Hello"); 


j 


// Output: Hello 


更 多 信息 
有 关 使 用 命名 空间 的 更 多 信息 ， 请 参见 下 列 主题 : 
e 命名 空间 (CH 编程 指南 ) 
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e 使 用 命名 空间 (CH 编程 指南 ) 
e 如何 : 使 用 全 局 命名 空间 别名 (CH 编程 指南 ) 
CH iF BME 


有 关 详 细 信 息 ， 请 参 阅 C# i Ta $m Bo 该 语言 规范 是 Cz 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

CH 编程 指南 

CH 关键 字 

命名 空间 关键 字 (CH 参考 ) 
using (C£ 参考 ) 


命名 空间 (C# 参考 ) 823 


using (CH 2) 


using 关键 字 有 两 个 主要 用 途 : 
e 作为 指令 ， 用 于 为 命名 空间 创建 别名 或 导 和 其 他 命名 空间 中 定义 的 类 型 。 请 参 


见 using #83. 


e 作为 语句 ， 用 于 定义 一 个 范围 ， 在 此 范围 的 末尾 将 释放 对 象 。 请 参见 using 语 


Flo 


请 参阅 

C4 参考 

C# 编程 指南 

CHART 

命名 空间 关键 字 (C# 参考 ) 
命名 空间 (CH 编程 指南 ) 
extern (C# 参考 ) 


using fat (CE 2) 


using 指令 有 三 种 用 途 : 
e 人 允许 在 命名 空间 中 使 用 类 型 ， 这 样 无 需 在 该 命名 空间 中 限定 某 个 类 型 的 使 用 : 


using System.Text; 

e 人 允许 访问 类 型 的 静态 成 员 ， 而 无 需 限定 使 用 类 型 名 称 进行 访问 : 
using static System.Math; 

e 为 命名 空间 或 类 型 创建 别名 。 这 称 为 using 9| i8. 


using Project = PC.MyCompany.Project; 


using 关键 字 还 用 于 创建 using 语句 ， 此 类 语句 有 助 于 确保 正确 处 理 |Disposable 
对 象 《如 文件 和 字体 ) 。 有 关 详 细 信 息 ， 请 参阅 using 语句 。 


Using Static 类 型 
你 可 以 访问 类 型 的 静态 成 员 ， 而 无 需 限定 使 用 类 型 名 称 进 行 访问 : 


using static System.Console; 
using static System.Math; 
class Program 


{ 
static void Main() 
1 
WriteLine(Sqrt(3*3 + 4*4)); 
} 
} 


Using static 仅 导 和 可 访问 的 静态 成 员 和 指定 类 型 中 声明 的 艇 套 类 型 。 不 导 人 继承 
的 成 员 。 可 以 从 任何 带 using static 指令 的 已 命名 类 型 导入 ， 包 括 Visual Basic 模 
块 。 如 果 FH 顶级 图 数 在 元 数据 中 显示 为 一 个 已 命名 类 型 (其 名 称 是 有 效 的 CH 标 
识 符 ) 的 静态 成 员 ， 则 可 以 导入 该 FE WR 


Using static 使 指定 类 型 中 声明 的 扩展 方法 可 用 于 扩展 方法 查找 。 但 是 ， 扩 展 方法 
的 名 称 不 导入 到 代码 中 非 限定 引用 的 作用 域 中 。 


同一 编译 单元 或 命名 空间 中 通过 不 同 using static 命令 从 不 同类 型 导入 的 具有 相同 
名 称 方法 组 成 一 个 方法 组 。 这 些 方法 组 内 的 重 载 解 决 方法 遵循 一 般 C# 规则 。 


各 注 
using 指 倒 的 范围 限于 显示 它 的 文件 。 


创建 using 别名 ， 以 便 更 易于 将 标识 符 限 定 为 命名 空间 或 类 型 。using HAHAH 
右 侧 必须 始终 是 一 个 完全 限定 类 型 ， 而 与 前 面 的 using HBA. 


创建 using 指 仿 ， 以 便 在 命名 空间 中 使 用 类 型 而 不 必 指 定 命名 空间 。 using 8T 

不 为 你 提供 对 嵌 套 在 指定 命名 空间 中 的 任何 命名 空间 的 访问 权限 。 

命名 空间 分 为 两 类 : 用 户 定义 的 命名 空间 和 系统 定义 的 命名 空间 。 用 户 定义 的 命名 
空间 是 在 代码 中 定义 的 命名 空间 。 有 关系 统 定 义 的 命名 空间 的 列表 ， 请 参阅 NET 

Framework 类 库 。 


有 关 引 用 其 他 程序 集中 的 方法 的 示例 ， 请 参阅 创建 和 使 用 C# DLL. 
示例 1 

说 明 

下 面 的 示例 显示 如 何 为 命名 空间 定义 和 使 用 using 别名 : 

代码 


namespace PC 


{ 
// Define an alias for the nested namespace. 
using Project = PC.MyCompany.Project; 


class A 
void M() 
// Use the alias 
Project.MyClass mc = new Project.MyClass(); 
} 
} 
namespace MyCompany 
{ 
namespace Project 
{ 
public class MyClass { } 
} 


批注 

using 别名 指令 的 右 侧 不 能 有 开放 式 泛 型 类 型 。 例 如 ， 不 能 为 List<T> 创建 using 
别名 ， 但 可 以 为 List<int> 创建 。 

示例 2 


说 明 
下 面 的 示例 显示 如 何 为 类 定义 using HPA using 别名 : 


代码 


using System; 


// Using alias directive for a class. 
using AliasToMyClass = NameSpace1.MyClass; 


// Using alias directive for a generic class. 
using UsingAlias = NameSpace2.MyClass<int>; 


namespace NameSpace1 


{ 
public class MyClass 
{ 
public override string ToString() 
{ 
return "You are in NameSpace1.MyClass."; 
j 
j 
j 
namespace NameSpace2 
{ 
class MyClass<T> 
{ 
public override string ToString() 
{ 
return "You are in NameSpace2.MyClass."; 
j 
j 
j 


namespace NameSpace3 


// Using directive: 
using NameSpace1; 


// Using directive: 
using NameSpace2; 


class MainClass 


{ 
static void Main() 
{ 
AliasToMyClass instance1 = new AliasToMyClass(); 
Console.WriteLine(instance1); 
UsingAlias instance2 - new UsingAlias(); 
Console.WriteLine(instance2); 
} 
} 
} 
// Output: 
// You are in NameSpace1.MyClass. 
// You are in NameSpace2.MyClass. 


有 关 详 细 信 息 ， 请 参阅 CEED. AAEM E C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

CH 编程 指南 

使 用 命名 空间 (CH 编程 指南 ) 
C# 关键 字 

命名 空间 关键 字 (CH 参考 ) 
命名 空间 (CH 编程 指南 ) 
using 语句 (CH 参考 ) 


using 语句 (C£ 2) 


提供 能 确保 正确 使 用 IDisposable 对 象 的 方便 语法 。 
下 面 的 示例 演示 如 何 使 用 using 语句 。 


using (Font fonti = new Font("Arial", 10.0f)) 


byte charset = fonti.GdiCharSet; 


备注 


File 和 Font 是 访问 非 托管 资源 〈 本 例 中 为 文件 句柄 和 设备 上 下 文 ) 的 托管 类 型 的 
示例 。 有 许多 其 他 类 别 的 非 托 管 资源 和 封装 这 些 资 源 的 类 库 类 型 。 所 有 这 些 类 型 都 
必须 实现 IDisposable 接口 。 


按照 规则 ， 当 使 用 IDisposable 对 象 时 ， 应 在 using 语句 中 声明 和 实例 化 此 对 象 。 

using 语句 按照 正确 的 方式 调用 对 象 上 的 Dispose 方法 ， 并 (在 您 按照 前 面 所 示 方 

式 使 用 它 时 ) 会 导致 在 调用 Dispose 时 对 象 自身 离开 作用 域 。 在 using H, WR 
是 只 读 的 并 且 无 法 修改 或 重新 赋值 。 


using 语句 确保 即使 在 调用 对 象 上 的 方法 时 发 生 有 异常 Dispose 方 法 也 会 被 调用 。 可 

通过 将 对 象 放 和 人 try 块 中 并 在 finally 块 中 调用 Dispose 来 达到 同样 的 结果 ; 实际 上 ， 

这 就 是 编译 器 转换 using 语句 的 方式 。 前 面 的 代码 示例 在 编译 时 将 扩展 为 以 下 代码 
(请 注意 ， 使 用 额外 的 大 括号 为 对 象 创 建 限制 范围 ) 


{ 
Font fonti = new Font("Arial", 10.0f); 
try 
byte charset = fonti.GdiCharSet; 
} 
finally 
{ 


if (font1 != null) 
((IDisposable)font1).Dispose(); 


如 下 面 的 示例 所 示 ， 可 以 在 using 语句 中 声明 一 个 类 型 的 多 个 实例 。 


using (Font font3 
font4 


new Font("Arial", 10.0f), 
new Font("Arial", 10.0f)) 


// Use font3 and font4. 


可 以 实例 化 资源 对 象 ， 然 后 将 变量 传递 给 using 语句 ， 但 这 不 是 最 佳 做 法 。 在 这 种 
情况 下 ， 该 对 象 将 在 控制 权 离开 using 块 之 后 保持 在 范围 内 ， 即 使 它 可 能 将 不 再 具 
有 对 其 非 托 管 资 源 的 访问 权 也 是 如 此 。 换 句 话说 ， 它 将 不 再 是 完全 初始 化 的 。 如 

尝试 在 using 块 外 部 使 用 该 对 象 ， 则 可 能 导致 引发 异常 。 由 于 这 个 原因 ， 通 常 
最 好 是 在 using 语句 中 实例 化 该 对 象 并 将 其 作用 域 限 制 到 using 块 中 。 


Font font2 = new Font("Arial", 10.0f); 
using (font2) // not recommended 


// use font2 
// font2 is still in scope 


// but the method call throws an exception 
float f - font2.GetHeight(); 


sein 
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Garbage Collection 


Implementing a Dispose Method 


外 部 别名 (CH 参考 ) 


能 必须 引用 两 个 具有 相同 完全 限定 类 型 名 的 程序 集 版 本 。 例 如 ， 可 能 必须 在 同一 
点 用 程序 中 使 用 程序 集 的 两 个 或 多 个 版 本 。 通过 使 用 外 部 程序 集 别名 ， 可 以 将 来 自 
每 个 程序 集 的 命名 空间 包装 在 由 别名 命名 的 根 级 别 命名 空间 中 ， 从 而 使 这 些 命 名 空 
间 可 以 在 同一 文件 中 使 用 。 


8 注意 
extern 关键 字 还 用 作 方 法 修饰 符 ， 声 明 用 非 托 管 代码 编写 的 方法 。 


若 要 引用 两 个 具有 相同 完全 限定 类 型 名 的 程序 集 ， 必 须 在 命令 提示 符 下 指定 别名 ， 
如 下 所 示 : 


/r:GridV1=grid.dll 
/r:GridV2=grid20.dll 


这 将 创建 外 部 别名 GridV1 和 GridV2。 若 要 从 程序 中 使 用 这 些 别 名 ， 请 使 用 extern 
关键 字 引 用 它们 。 例 如 : 


extern alias GridV1; 

extern alias GridV2; 

每 一 个 外 部 别名 声明 都 引入 一 个 额外 的 根 级 别 命 名 空间 ， 它 与 全 局 命名 空间 平行 ， 
而 不 是 在 全 局 命名 空间 内 。 因 此 ， 通 过 使 用 根源 于 相应 命名 空间 别名 的 完全 限定 
名 ， 可 以 无 歧义 地 引用 每 个 程序 集 的 类 型 。 


在 上 面 的 示例 中 ，GridV1::Grid 是 来 自 grid.dll 的 网 格 控 件 ， 而 GridV2::Grid 是 来 
El grid20.dll 的 网 格 控件 。 

C4 语言 规 学 
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EAS (C# 参考 ) 
用 于 执行 其 他 操作 (如 创建 对 象 ， 检 查 对 象 的 运行 时 类 型 ， 获 取 类 型 的 大 小 和 其 他 
操作 。 本 节 介 绍 下 列 关 键 字 : 
e as 将 对 象 转换 为 可 兼容 类 型 。 
e 等 待 挂 起 异步 方法 ， 直 到 其 中 一 等 待 任务 完成 。 
e is 检查 对 象 的 运行 时 类 型 。 
e new 
o new 运算 符 创建 对 象 。 
o new 修饰 符 隐藏 继承 成 员 。 
o new 约束 限定 类 型 参数 。 
sizeof 获取 类 型 的 大 小 。 
typeof 获取 类 型 的 System.Type 对 象 。 


e true 
o true 运算 符 返回 布尔 值 true 表示 真 ， 否 则 返回 false。 
o true 表示 布尔 值 true。 

e false 
o false 运算 符 返回 布尔 值 true 表示 假 ， 否 则 返回 false. 
o false 表示 布尔 值 false, 

e stackalloc 在 堆栈 上 分 配 内 存 块 。 

在 语句 一 节 中 介绍 了 下 列 可 用 作 运 算 符 和 语句 的 关键 字 : 
e checked 指定 已 检查 的 上 下 文 。 
e unchecked 指定 未 检查 的 上 下 文 。 


请 参阅 
C# 参考 


C 编程 指南 
C# 关键 字 
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as (C4 2) 


可 以 使 用 as 运算 符 执行 转换 的 某 些 类 型 在 兼容 之 间 的 引用 类 型 或 可 以 为 null 的 类 
型 。 下 面 的 代码 提供 了 一 个 示例 。 


class csrefKeywordsOperators 


{ 
class Base 
public override string ToString() 
{ 
return "Base"; 
} 
class Derived : Base 
td 
class Program 
{ 
static void Main() 
t 
Derived d - new Derived(); 
Base b - d as Base; 
if (b != null) 
{ 
Console.WriteLine(b.ToString()); 
} 
} 
} 
} 


备注 
as 运算 符 类 似 于 强制 转换 操作 。 但 是 ， 因 此 ， 如 果 转 换 是 不 可 能 的 ，as 返回 null 
而 不 引发 异常 。 请 看 下 面 的 示例 : 


expression as type 


代码 与 下 面 的 表达 式 是 等 效 的 ， 但 expression 变量 只 计算 一 次 。 


expression is type ? (type)expression : (type)null 


请 注意 as 运算 符 执行 只 引用 转换 、nullable 转换 和 装 箱 转换 。 
其 他 转换 ， 如 用 户 定义 的 转换 ， 应 是 通过 使 用 转换 的 表达 式 。 


class ClassA ( } 
class ClassB ( } 


class MainClass 


{ 
static void Main() 
{ 
object[] objArray = new object[6]; 
objArray[0] = new ClassA(); 
objArray[1] = new ClassB(); 
objArray[2] = "hello"; 
objArray[3] = 123; 
objArray[4] = 123.4; 
objArray[5] = null; 
for (int i = 0; i < objArray.Length; ++i) 
{ 
string s = objArray[i] as string; 
Console.write("[0):", i); 
if (s != null) 
{ 
Console. WriteLine("'" + s + "'"); 
} 
else 
Console.WriteLine("not a string"); 
} 
} 
} 
} 
Ye 
Output: 
0:not a string 
1:not a string 
2:'hello' 
3:not a string 
4:not a string 
5:not a string 
= 
m ze 
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as i 


运算 符 不 能 执行 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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as (C# 参考 ) 
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await (C£ 参考 ) 


await 运算 符 在 异步 方法 应 用 于 任务 ， 以 挂 起 执行 方法 ， 直 到 所 等 待 的 任务 完成 。 
任务 表示 正在 进行 的 工作 。 


在 其 中 使 用 a 须 通 过 async 关键 字 进 行 修改 。 使 用 async 修饰 
符 定 义 并 且 通 一 个 或 多 个 await 表达 式 的 这 这 类 法 称 关 异步 方法 。 


y 
Ef TER 


async 和 await 关键 字 是 在 Visual Studio 2012 中 引入 的 。 有 关 异 步 编程 的 说 
明 ， 请 参阅 使 用 Async 和 Await 的 异步 编程 (C# 和 Visual Basic) 。 


应 用 await 运算 符 的 任务 通常 是 实现 基于 任务 的 异步 模式 的 方法 调用 的 返回 值 。 示 
例 包 括 Task 或 Task<TResult> 类 型 的 值 。 


在 以 下 代码 中 ，HttpClient 方法 GetByteArrayAsync 返回 Task«byte[]» 
(getContentsTask)。 当 任务 完成 时 ， 任 务 约定 生成 实际 字 节 数组 。 await 运算 符 应 
用 于 getContentsTask 以 在 SumPageSizesAsync 中 挂 起 执行 ， 直 到 
getContentsTask 完成 。 同 时 ， 控 制 权 会 返回 给 SumPageSizesAsync 的 调用 方 。 
当 getContentsTask 完成 之 后 ，await 表达 式 计 算 为 字 节 数组 。 


private async Task SumPageSizesAsync() 

{ 
// To use the HttpClient type in desktop apps, you must include 
// reference for the System.Net.Http namespace. 
HttpClient client = new HttpClient(); 
MU an 
Task<byte[]> getContentsTask = client.GetByteArrayAsync(ur1); 
byte[] urlContents = await getContentsTask; 


// Equivalently, now that you see how it works, you can write 1 
//byte[] urlContents = await client.GetByteArrayAsync(url); 
"P CNET 





4 重要 事项 


有 关 完 整 示例 ， 请 参阅 演练 : 使 用 Async 和 Await 访问 Web (C£ 和 Visual 
Basic) 。 可 以 从 Microsoft 网 站 上 的 开发 人 员 代 码 示例 下 载 该 示例 。 该 示例 处 
于 AsyncWalkthrough HttpClient 项 目 中 。 


如 前 面 的 示例 中 所 示 ， 如 果 await 应 用 于 返回 Task<TResult> 的 方法 调用 结果 ， 
则 await 表达 式 的 类 型 为 TResult。 如 果 await 应 用 于 返回 Task 的 方法 调用 结 
果 ， 则 await 表达 式 的 类 型 为 void。 以 下 示例 演示 了 差异 。 


// Keyword await used with a method that returns a Task<TResult>. 
TResult result - await AsyncMethodThatReturnsTaskTResult(); 


// Keyword await used with a method that returns a Task. 

await AsyncMethodThatReturnsTask(); 
«| En >| 
await 表达 式 不 阻止 正在 执行 它 的 线程 。 而 是 使 编译 器 将 剩 下 的 异步 方法 注册 为 等 
待 任务 的 延续 任务 。 控 制 权 随后 会 返回 给 异步 方法 的 调用 方 。 任 务 完 成 时 ， 它 会 调 
用 其 延续 任务 ， 异 步 方法 的 执行 会 在 暂停 的 位 置 处 恢复 。 


await 表达 式 只 能 在 由 async 修饰 符 标记 的 立即 封闭 方法 体 、lambda 表达 式 或 异 
步 方法 中 出 现 。 术 语 “wait* 在 该 上 下 文中 仅 用 作 关 键 字 。 在 其 他 位 置 ， 它 会 解释 为 
标识 符 。 在 方法 、lambda 表达 式 或 匿名 方法 中 ，await 表达 式 不 能 在 同步 范 数 体 、 
查询 表达 式 、|lock 语句 块 或 不 安全 上 下 文中 出 现 。 





ce nu 
FF rnm 


大 多 数 异步 方法 返回 Task 或 Task<TResult>。 返 回 任务 的 属性 携带 有 关 其 状态 和 
历史 记录 的 信息 ， 如 任务 是 否 完成 、 异 步 方法 是 否 导致 异常 或 已 取消 以 及 最 终结 果 
是 什么 。 await 运算 符 可 访问 这 些 属 性 。 


如 果 等 待 的 任务 返回 异步 方法 导致 异常 ， 则 await 运算 符 会 重新 引发 异常 。 
如 果 等 待 的 任务 返回 异步 方法 取消 ， 则 await 运算 符 会 重新 引发 


OperationCanceledException。 


处 于 故障 状态 的 单个 任务 可 以 反映 多 个 异常 。 例 如 ， 任 务 可 能 是 对 Task.WhenAll 
调用 的 结果 。 等 待 此 类 任务 时 ， 等 待 操作 仅 重 新 引发 异常 之 一 。 但 是 ， 无 法 预测 重 
新 引发 的 异常 。 


有 关 异 步 方 法 中 的 错误 处 理 的 示例 ， 请 参阅 try-catch (CH 参考 ) 。 


下 面 的 Windows 窗 体 示例 阐释 如 何在 异步 方法 WaitAsynchronouslyAsync 中 使 用 
await。 将 该 方法 的 行为 与 WaitSynchronously 的 行为 进行 对 比 。 如 果 未 向 任务 应 
用 await 运算 符 ，WaitSynchronously 就 会 同步 运行 ， 而 不 管 其 定义 中 是 否 使 用 了 
async 修饰 符 和 在 主体 中 是 否 调 用 了 Thread.Sleep。 


private async void buttoni Click(object sender, EventArgs e) 
{ 

// Call the method that runs asynchronously. 

string result = await WaitAsynchronouslyAsync(); 


// Call the method that runs synchronously. 
//string result = await WaitSynchronously (); 


// Display the result. 
textBox1.Text += result; 


} 


// The following method runs asynchronously. The UI thread is not 
// blocked during the delay. You can move or resize the Formi wind 
// while Task.Delay is running. 
public async Task«string» WaitAsynchronouslyAsync() 
{ 

await Task.Delay(10000); 

return "Finished"; 


} 


// The following method runs synchronously, despite the use of asyr 
// You cannot move or resize the Formi window while Thread.Sleep 
// is running because the UI thread is blocked. 

public async Task<string> WaitSynchronously() 


// Add a using directive for System.Threading. 
Thread.Sleep(10000); 
return "Finished"; 





请 参阅 


使 用 Async 和 Await 的 异步 编程 (C# 和 Visual Basic) 
演练 : 使 用 Async 和 Await 访问 Web (C£ 和 Visual Basic) 
async (C£ 2X) 


is (C# 参考 ) 


检查 对 象 是 否 与 给 定 类 型 兼容 。 例 如 ， 下 面 的 代码 可 以 确定 对 象 是 否 为 MyObject 
类 型 的 一 个 实例 ， 或 者 对 象 是 否 为 从 MyObject 派生 的 一 个 类 型 : 

if (obj is MyObject) 

} 
如 果 所 提供 的 表达 式 非 空 ， 并 且 所 提供 的 对 象 可 以 强制 转换 为 所 提供 的 类 型 而 不 会 
导致 引发 异常 ， 则 is 表达 式 的 计算 结果 将 是 true。 


如 果 已 知 表 达 式 将 始终 是 true 或 始终 是 false， 则 is 关键 字 将 导致 编译 时 警告 ， 但 
是 ， 通 常 在 运行 时 才 计 算 类 型 兼容 性 。 


不 能 重 载 is 运算 符 。 


请 注意 ，is 运算 符 只 考虑 引用 转换 、 装 箱 转 换 和 取消 装 箱 转 换 。 不 考虑 其 他 转换 ， 
如 用 户 定义 的 转换 。 


在 is 运算 符 的 左 侧 不 允许 使 用 匿名 方法 。lambda 表达 式 属 于 例外 。 


class Classi {} 
class Class2 {} 
class Class3 : Class2 { } 


class IsTest 


{ 


static void Test(object o) 


( 


Class1 a; 
Class2 b; 


if (o is Class1) 
{ 


Console.WriteLine("o 
a = (Class1)o; 
// Do something with 


else if (o is Class2) 


{ 


Console.WriteLine("o 

b = (Class2)o; 

// Do something with 
} 


else 


{ 


} 
} 
static void Main() 


í 


Console.WriteLine("o 


Classi c1 
Class2 c2 
Class3 c3 
Test(c1); 
Test(c2); 
Test(c3); 
Test("a string"); 


new Class1(); 
new Class2(); 
new Class3(); 


} 

irs 

Output: 

o is Class1 

o is Class2 

o is Class2 

o is neither Classi nor Class2. 


is 


is 


ups 


is 


Class1"); 


Class2"); 


neither Classi nor Class2."); 
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typeof (C# 参考 ) 

as (C# 参考 ) 
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is (C# 参考 ) 


843 


new (C4 参考 ) 


ft C4 rh, new 关键 字 可 用 作 运 算 符 、 修 饰 符 或 约束 。 
new 运算 符 

用 于 创建 对 象 和 调用 构造 酚 数 。 

new 修饰 符 

用 于 隐藏 基 类 中 被 继承 的 成 员 。 

new 约束 

用 于 在 泛 型 声明 中 约束 可 能 用 作 类 型 参数 的 参数 的 类 型 。 


请 参阅 
C# 参考 
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new ZH (CH 参考 ) 
PAF Olt RAL SEP, DID : 


Classi obj = new Classi(); 


还 可 用 于 创建 匿名 类 型 的 实例 : 


var query = from cust in customers 
select new {Name = cust.Name, Address = cust.PrimaryAdc 


T) 
new iz $41 A FAA E RERA. PN : 





int i - new int(); 


在 上 一 个 语句 中 ，i 初始 化 为 0， 它 是 int 类 型 的 默认 值 。 该 语句 的 效果 等 同 于 : 


int i = 0; 


有 关 黑 认 值 的 完整 列表 ， 请 参见 默认 值 表 〈C# 参考 ) 。 

请 记 住 ， 为 结构 声明 默认 的 构造 本 数 是 错误 的 ， 因 为 每 一 个 值 类 型 都 隐 式 具有 一 个 
公共 的 默认 构造 画 数 。 可 以 在 结构 类 型 上 声明 参数 化 构造 画 数 以 设置 其 初始 值 ， 但 
是 ， 只 有 在 需要 默认 值 之 外 的 值 时 才 必 须 这 样 做 。 

值 类 型 对 象 (例如 结构 ) 是 在 堆栈 上 创建 的 ， 而 引用 类 型 对 象 (例如 类 ) 是 在 堆 上 
创建 的 。 两 种 类 型 的 对 象 都 是 自动 销毁 的 ， 但 是 ， 基 于 值 类 型 的 对 象 是 在 超出 范围 
时 销毁 ， 而 基于 引用 类 型 的 对 象 则 是 在 对 该 对 象 的 最 后 一 个 引用 被 移 除 之 后 在 某 个 
不 确定 的 时 间 销 毁 。 对 于 占用 固定 资源 〈 例 如 大 量 内 存 、 文 件 句柄 或 网 络 连接 ) 的 
引用 类 型 ， 有 时 需要 使 用 确定 性 终止 以 确保 对 象 被 尽快 销毁 。 有 关 更 多 信息 ， 请 参 
见 using 语句 (CH 参考 ) 。 

不 能 重 载 new 运算 符 。 

如 果 new 运算 符 分 配 内 存 失败 ， 将 引发 异常 OutOfMemoryException。 

在 下 面 的 示例 中 ， 通 过 使 用 new 运算 符 创 建 并 初始 化 一 个 struct 对 象 和 一 个 类 对 
象 ， 然 后 为 它们 赋值 。 显 示 了 默认 值 和 所 赋 的 值 。 


struct SampleStruct 


public int x; 


public int y; 


public SampleStruct(int x, int y) 


t 
this.x = x; 
this.y = y; 
j 
j 
class SampleClass 
{ 
public string name; 
public int id; 
public SampleClass() {} 
public SampleClass(int id, string name) 
{ 
this.id = id; 
this.name = name; 
} 
} 
class ProgramClass 
{ 
static void Main() 
{ 
// Create objects using default constructors: 
SampleStruct Location1 = new SampleStruct(); 
SampleClass Employee1 = new SampleClass(); 
// Display values: 
Console.WriteLine("Default values:"); 
Console.WriteLine(" Struct members: {0}, {1}", 
Locationi.x, Locationi.y); 
Console.WriteLine(" Class members: {0}, {1}", 
Employeei.name, Employeei.id); 
// Create objects using parameterized constructors: 
SampleStruct Location2 - new SampleStruct(10, 20); 
SampleClass Employee2 - new SampleClass(1234, "Cristina Potr: 
// Display values: 
Console.WriteLine("Assigned values:"); 
Console.WriteLine(" Struct members: {0}, {1}", 
Location2.x, Location2.y); 
Console.WriteLine(" Class members: (0), {1}", 
Employee2.name, Employee2.id); 
j 
j 
JES 
Output: 


Default values: 


Struct members: ©, 0 

Class members: , 0 
Assigned values: 

Struct members: 10, 20 

Class members: Cristina Potra, 1234 
ae 


Kil 
注意 ， 在 示例 中 字符 串 的 默认 值 为 null， 因 此 未 显示 它 。 
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new 修饰 符 (CH 参考 ) 


在 用 作 声 明 修 饰 符 时 ，new 关键 字 可 以 显 式 隐藏 从 基 类 继承 的 成 员 。 隐 藏 继承 的 成 
员 时 ， 该 成 员 的 派生 版 本 将 替换 基 类 版 本 。 哩 然 可 以 不 使 用 new 修饰 符 来 隐藏 成 
员 ， 但 将 收 到 编译 器 警告 。 如 果 使 用 new 来 显 式 隐藏 成 员 ， 将 茶 止 此 警告 。 


若 要 隐藏 继承 的 成 员 ， 请 使 用 相同 名 称 在 派生 类 中 声明 该 成 员 ， 并 使 用 new 修饰 
符 对 其 进行 修饰 。 例 如 : 


public class BaseC 


{ 
public int x; 
public void Invoke() ( } 


public class DerivedC : BaseC 


new public void Invoke() ( } 


在 此 示例 中 ， 使 用 BaseC.Invoke 隐藏 了 DerivedC.Invoke, FR x 不 受 影响 ， 
为 未 使 用 类 似 名 称 将 其 隐藏 。 


通过 继承 隐藏 名 称 采用 下 列 形式 之 一 : 


e 通常 ， 在 类 或 结构 中 引入 的 常数 、 字 段 、 属 性 或 类 型 会 隐藏 与 其 共享 名 称 的 所 
有 基 类 成 员 。 有 三 种 特殊 情况 。 例 如 ， 如 果 将 名 称 为 N 的 新 字段 声明 为 不 可 调 
用 的 类 型 ， 并 且 基 类 型 将 N 声明 为 一 种 方法 ， 则 新 字段 在 调用 语法 中 不 会 隐藏 
eee ee eee 
部 分 


。 类 或 结构 中 引入 的 方法 会 隐藏 基 类 中 共享 该 名 称 的 属性 、 字 段 和 类 型 。 它 还 会 
隐藏 具有 相同 签名 的 所 有 基 类 方法 。 


e 类 或 结构 中 引入 的 索引 器 会 隐藏 具有 相同 签名 的 所 有 基 类 索引 器 。 


对 同一 成 员 同 时 使 用 new 和 override 是 错误 的 做 法 ， 因 为 这 两 个 修饰 符 的 含义 互 
Ro new 修饰 符 会 用 同样 的 名 称 创建 一 个 新 成 员 并 使 原始 成 员 变 为 隐藏。 
override 修饰 符 会 扩展 继承 成 员 的 实现 。 


在 不 隐藏 继承 成 员 的 声明 中 使 用 new 修饰 符 将 会 生成 警告 。 


在 此 示例 中 ， 基 类 BaseC 和 派生 类 DerivedC 使 用 相同 的 字段 名 x， 从 而 隐藏 了 继 
承 字段 的 值 。 此 示例 演示 new 修饰 符 的 用 法 。 另外 还 m RE 
访问 基 类 的 隐藏 成 员 。 


public class BaseC 


{ 
public static int x = 55; 
public static int y = 22; 
j 
public class DerivedC : BaseC 
{ 
// Hide field 'x'. 
new public static int x - 100; 
static void Main() 
{ 
// Display the new value of x: 
Console.WriteLine(x); 
// Display the hidden value of x: 
Console.WriteLine(BaseC.x); 
// Display the unhidden member y: 
Console.WriteLine(y); 
j 
} 
V 
Output: 
100 
55 
22 
Ey 


TERAP, RE X i SRSAABAM A, TARRAA new 修饰 符 来 
消除 警告 消息 ， 以 及 如 何 使 用 完全 限定 名 来 访问 隐藏 的 类 成 员 。 


public class BaseC 


{ 
public class NestedC 
{ 
public int x = 200; 
public int y; 
} 
} 
public class DerivedC : BaseC 
{ 
// Nested type hiding the base type members. 
new public class NestedC 
{ 
public int x = 100; 
public int y; 
public int z; 
} 
static void Main() 
{ 
// Creating an object from the overlapping class: 
NestedC c1 = new NestedC(); 
// Creating an object from the hidden class: 
BaseC.NestedC c2 = new BaseC.NestedC(); 
Console.WriteLine(c1.x); 
Console.WriteLine(c2.x); 
} 
} 
yas 
Output 
100 
200 
af 


如 果 移 除 new 修饰 符 ， 程 序 仍 将 编译 和 运行 ， 但 你 会 收 到 以 下 警告 


The keyword new is required on 'MyDerivedC.x' because it hides inhe 
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new 修饰 符 (CH 参考 ) 
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new 约束 (Cit 2X) 


new 约束 指定 泛 型 类 a psa 须 有 公共 的 无 参数 构造 画 数 。 如 果 
要 使 用 new 约束 ， 则 该 类 能 为 抽象 类 型 。 


Wan ee 请 将 new 约束 应 用 于 类 型 参数 ， 如 下 面 的 示例 所 
小 : 


class ItemFactory<T> where T : new() 


{ 
public T GetNewItem() 
{ 
return new T(); 
} 
} 


当 与 其 他 约束 一 起 使 用 时 ，new() 约束 必须 最 后 指定 : 


public class ItemFactory2<T> 
where T : IComparable, new() 


{ 
} 


有 关 更 多 信息 ， 请 参见 类 型 参数 的 约束 (CH 编程 指南 ) o 
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sizeof (C# 参考 ) 

用 于 获取 非 托管 类 型 的 大 小 (以 字 节 为 单位 ) 。 非 托管 类 型 包括 下 表 列 出 的 内 置 类 
型 以 及 以 下 类 型 : 

。 枚 举 类 型 

。 指 针 类 型 

。 用 户 定义 的 站 构 ， 不 包含 任何 属于 引用 类 型 的 字段 或 属性 

下 面 的 示例 演示 如 何 检索 int 的 大 小 : 


// Constant value 4: 
int intSize - sizeof(int); 


备注 
从 C# 2.0 版 开始 ， 将 sizeof 应 用 于 内 置 类 型 不 再 要 求 使 用 unsafe 模式 。 
TREER sizeof 运算 符 。 sizeof 运算 符 的 返回 值 是 int 类 型 。 下 表 列 出 了 一 些 常 
量 值 ， 这 些 值 对 应 于 以 某 些 内 置 类 型 为 操作 数 的 sizeof 表达 式 。 
表达 式 常量 值 

sizeof(sbyte) 1 

sizeof(byte) 1 

sizeof(short) 

sizeof(ushort) 

sizeof(int) 


sizeof(uint) 


sizeof(ulong) 
sizeof(char) (Unicode) 


sizeof(float) 


co|4|[N|[o|o 4 A] PD] DY 


sizeof(double) 


sizeof(decimal) 16 


( 
( 
( 
( 
( 
( 
sizeof(long) 
( 
( 
( 
( 
( 
( 


sizeof(bool) 1 


对 于 所 有 其 他 类 型 (包括 结构 ) ，sizeof 运算 符 只 能 在 不 安全 代码 块 中 使 用 。 尽 管 
可 以 使 用 Marshal.SizeOf 方法 ， 但 此 方法 返回 的 值 并 不 总 是 与 sizeof 返回 的 值 相 
fal, Marshal.SizeOf 在 封 送 类 型 后 返回 大 小 ， 而 sizeof 返回 公共 语言 运行 时 分 配 
的 大 小 〈 包 括 所 有 填充 ) 。 


class MainClass 


{ 
// unsafe not required for primitive types 
static void Main() 
{ 
Console.WriteLine("The size of short is {0}.", sizeof(shori 
Console.WriteLine("The size of int is {0}.", sizeof(int)); 
Console.WriteLine("The size of long is {0}.", sizeof(long): 
} 
} 
Js 
Output: 
The size of short is 2. 
The size of int is 4. 
The size of long is 8. 
zu 
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typeof (C£ 2) 
用 于 获取 类 型 的 System.Type stk. typeof 表达 式 采 用 以 下 形式 : 


System.Type type = typeof(int); 


各 注 
若 要 获取 表达 式 的 运行 时 类 型 ， 可 以 使 用 .NET Framework 方法 GetType， 如 以 下 
示例 中 所 示 : 


int i- 0; 
System.Type type = i.GetType( ); 


TREER typeof 运算 符 。 
typeof 运算 符 也 能 用 于 公开 的 泛 型 类 型 。 具 有 不 止 一 个 类 型 参数 的 类 型 的 规范 中 必 


须 有 适当 数量 的 逗号。 下 面 的 示例 演示 如 何 确 定 方 法 的 返回 类 型 是 否 是 泛 型 
IEnumerable<T>。 假定 此 方法 是 Methodlnfo 类 型 的 实例 : 


string s = method.ReturnType.GetInterface 
(typeof (System.Collections.Generic.IEnumerable<>) .FullName) ; 


public class ExampleClass 

X 
public int sampleMember; 
public void SampleMethod() {} 


static void Main() 
{ 
Type t = typeof(ExampleClass); 
// Alternatively, you could use 
// ExampleClass obj = new ExampleClass(); 
// Type t = obj.GetType(); 


Console.WriteLine("Methods:"); 
System.Reflection.MethodInfo[] methodInfo - t.GetMethods(); 


foreach (System.Reflection.MethodInfo mInfo in methodInfo) 
Console.WriteLine(mInfo.ToString()); 


Console.WriteLine("Members:"); 
System.Reflection.MemberInfo[] memberInfo - t.GetMembers(); 


foreach (System.Reflection.MemberInfo mInfo in memberInfo) 
Console.WriteLine(mInfo.ToString()); 


} 

/* 

Output: 
Methods: 
Void SampleMethod() 
System.String ToString() 
Boolean Equals(System.Object) 
Int32 GetHashCode() 
System.Type GetType() 
Members: 
Void SampleMethod() 
System.String ToString() 
Boolean Equals(System.Object ) 
Int32 GetHashCode() 
System.Type GetType() 
Void .ctor() 
Int32 sampleMember 

2 


[| 


此 示例 使 用 GetType 方法 确定 用 来 包含 数值 计算 的 结果 的 类 型 。 这 取决 于 结果 数字 
的 存储 要 求 。 


class GetTypeTest 


{ 
static void Main() 
{ 
int radius = 3; 
Console.WriteLine("Area = {0}", radius * radius * Math.PI), 
Console.WriteLine("The type is {0}", 
(radius * radius * Math.PI).GetType() 
); 
} 
} 
Vas 
Output: 


Area = 28.2743338823081 
The type is System.Double 
m 
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true (CX 2) 


用 作 重 载运 算 符 或 文本 : 
true 运算 符 
true 标识 符 


请 参阅 
CH 参考 


C 编程 指南 
C# 关键 字 


true zB (CH 2X) 


返回 布尔 值 true 以 指示 操作 数 为 true， 否 则 返回 false. 


在 C# 2.0 以 前 ，true 和 false 运算 符 一 E 户 定义 的 可 以 为 null 的 值 类 
型 ， 这 些 值 类 型 与 SqlBool 等 类 型 兼容 。 然 而 ， 现 在 该 语言 提供 对 可 为 nul 的 值 
类 型 的 内 置 支持 ， 并 且 应 该 尽 可 能 地 使 用 WO true 和 false 运算 符 。 有 
关 更 多 信息 ， 请 参见 可 以 为 null 的 类 型 (CH 编程 指南 ) o 


对 于 可 以 为 null 的 布尔 值 ， 表达 式 al= b 不 一 定 等 同 于 !(a == b)， 因 为 两 个 值 之 一 
或 者 全 部 都 有 可 能 为 null。 需 要 单独 重 载 true 和 false 运算 符 ， 以 便 正 确 标识 表达 
式 中 的 null 值 。 下 面 的 示例 演示 如 何 重 载 及 使 用 true 和 false 运算 符 。 


// For example purposes only. Use the built-in nullable bool 
// type (bool?) whenever possible. 
public struct DBBool 
{ 
// The three possible DBBool values. 
public static readonly DBBool Null = new DBBool(0); 
public static readonly DBBool False = new DBBool(-1); 
public static readonly DBBool True = new DBBool(1); 
// Private field that stores -1, 0, 1 for False, Null, True. 
sbyte value; 
// Private instance constructor. The value parameter must be -: 
DBBool(int value) 


{ 
} 


// Properties to examine the value of a DBBool. Return true if 
// DBBool has the given value, false otherwise. 

public bool IsNull { get { return value == 0; } ) 

public bool IsFalse { get { return value < 0; } } 

public bool IsTrue { get { return value > 0; } } 

// Implicit conversion from bool to DBBool. Maps true to DBBoo- 
// false to DBBool.False. 

public static implicit operator DBBool(bool x) 


{ 
} 


// Explicit conversion from DBBool to bool. Throws an exceptior 
// given DBBool is Null; otherwise returns true or false. 
public static explicit operator bool(DBBool x) 


( 


this.value - (sbyte)value; 


return x ? True : False; 


if (x.value -- 0) throw new InvalidOperationException(); 
return x.value » 0; 


// Equality operator. Returns Null if either operand is Null; « 
// returns True or False. 
public static DBBool operator --(DBBool x, DBBool y) 


if (x.value -- || y.value == 0) return Null; 

return x.value -- y.value ? True : False; 
} 
// Inequality operator. Returns Null if either operand is Null, 
// returns True or False. 
public static DBBool operator !=(DBBool x, DBBool y) 
{ 

if (x.value == || y.value == 0) return Null; 

return x.value != y.value ? True : False; 
} 
// Logical negation operator. Returns True if the operand is Fé 
// if the operand is Null, or False if the operand is True. 
public static DBBool operator !(DBBool x) 


{ 
} 


// Logical AND operator. Returns False if either operand is Fa: 
// Null if either operand is Null, otherwise True. 
public static DBBool operator &(DBBool x, DBBool y) 


£ 
} 


// Logical OR operator. Returns True if either operand is True, 
// Null if either operand is Null, otherwise False. 
public static DBBool operator |(DBBool x, DBBool y) 


( 


return new DBBool(-x.value); 


return new DBBool(x.value « y.value ? x.value : y.value); 


return new DBBool(x.value » y.value ? x.value : y.value); 


// Definitely true operator. Returns true if the operand is Trt 
// otherwise. 
public static bool operator true(DBBool x) 


t 
} 


// Definitely false operator. Returns true if the operand is Fé 
// otherwise. 
public static bool operator false(DBBool x) 


return x.value > 0; 


: return x.value < 0; 

RA override bool Equals(object obj) 

: if (!(0bj is DBBool)) return false; 
return value == ((DBBool)obj).value; 

abies override int GetHashCode( ) 

: return value; 

pubic override string ToString() 


if (value » 0) return "DBBool.True"; 


if (value « 0) return "DBBool.False"; 
return "DBBool.Null"; 


j 





zj 


重 载 true 和 false 运算 符 的 类 型 可 以 用 于 计 _ do, while 和 for 语句 以 及 条 件 表 过 
式 中 的 控制 表达 式 。 
如 果 类 型 定义 了 true 运算 符 ， 它 还 必须 定义 false 运算 符 。 


类 型 不 能 直接 重 载 条 件 逻 辑 运 算 符 (&& 和 ||) ， 但 通过 重 载 规则 逮 辑 运算 符 和 
true 5 false 运算 符 可 以 达到 同样 的 效果 。 
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C# 运算 符 

false (C# 参考 ) 


true FHA (CH 参考 ) 


表示 布尔 值 true. 
class TrueTest 
{ 
static void Main() 
bool a = true; 
Console.WriteLine( a ? "yes" : "no" ); 
} 
} 
ie 
Output : 
yes 
B 


m d 

C# j2 5 #3 

有 关 详 细 信 息 ， 请 参阅 CH 话 言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
请 参阅 

CH 参考 

C# 编程 指南 


C# 关键 字 
false (C4 参考 ) 


false (C4 BS) 


用 作 重 载运 算 符 或 文本 : 
e false 运算 符 


e false 标识 符 
请 参阅 
CH 参考 


C# 编程 指南 
C# 关键 字 


false ZAR (Cft SA) 


返回 布尔 值 true LASER false, AiR) false. 


在 C# 2.0 LABT, true 和 false 运算 符 一 E 户 定义 的 可 以 为 null 的 值 类 
型 ， 这 些 值 类 型 与 SqlBool 等 类 型 兼容 。 然 而 ， 现 在 该 语言 提供 对 可 为 null 的 值 
类 型 的 内 置 支持 ， 并 且 应 该 尽 可 能 地 使 用 WL eerie a true 和 false 运算 符 。 有 
关 更 多 信息 ， 请 参见 可 以 为 null 的 类 型 (CH 编程 指南 ) o 


对 于 可 以 为 null 的 布尔 值 ， 表 达 式 a l= b 不 一 定 等 同 于 !(a == b)， 因 为 两 个 值 之 一 
或 者 全 部 都 有 可 能 为 null。 必 须 单 独 重 载 true 和 false 运算 符 ， 以 便 正确 处 理 表 达 
式 中 的 null 值 。 下 面 的 示例 演示 如 何 重 载 及 使 用 true 和 false 运算 符 。 


// For example purposes only. Use the built-in nullable bool 
// type (bool?) whenever possible. 
public struct DBBool 
{ 
// The three possible DBBool values. 
public static readonly DBBool Null = new DBBool(0); 
public static readonly DBBool False = new DBBool(-1); 
public static readonly DBBool True = new DBBool(1); 
// Private field that stores -1, 0, 1 for False, Null, True. 
sbyte value; 
// Private instance constructor. The value parameter must be -: 
DBBool(int value) 


{ 
} 


// Properties to examine the value of a DBBool. Return true if 
// DBBool has the given value, false otherwise. 

public bool IsNull { get { return value == 0; } ) 

public bool IsFalse { get { return value < 0; } } 

public bool IsTrue { get { return value > 0; } } 

// Implicit conversion from bool to DBBool. Maps true to DBBoo- 
// false to DBBool.False. 

public static implicit operator DBBool(bool x) 


{ 
} 


// Explicit conversion from DBBool to bool. Throws an exceptior 
// given DBBool is Null; otherwise returns true or false. 
public static explicit operator bool(DBBool x) 


( 


this.value - (sbyte)value; 


return x ? True : False; 


if (x.value -- 0) throw new InvalidOperationException(); 
return x.value » 0; 


// Equality operator. Returns Null if either operand is Null; « 
// returns True or False. 
public static DBBool operator --(DBBool x, DBBool y) 


if (x.value -- || y.value == 0) return Null; 

return x.value -- y.value ? True : False; 
} 
// Inequality operator. Returns Null if either operand is Null, 
// returns True or False. 
public static DBBool operator !=(DBBool x, DBBool y) 
{ 

if (x.value == || y.value == 0) return Null; 

return x.value != y.value ? True : False; 
} 
// Logical negation operator. Returns True if the operand is Fé 
// if the operand is Null, or False if the operand is True. 
public static DBBool operator !(DBBool x) 


{ 
} 


// Logical AND operator. Returns False if either operand is Fa: 
// Null if either operand is Null, otherwise True. 
public static DBBool operator &(DBBool x, DBBool y) 


£ 
} 


// Logical OR operator. Returns True if either operand is True, 
// Null if either operand is Null, otherwise False. 
public static DBBool operator |(DBBool x, DBBool y) 


( 


return new DBBool(-x.value); 


return new DBBool(x.value « y.value ? x.value : y.value); 


return new DBBool(x.value » y.value ? x.value : y.value); 


// Definitely true operator. Returns true if the operand is Trt 
// otherwise. 
public static bool operator true(DBBool x) 


t 
} 


// Definitely false operator. Returns true if the operand is Fé 
// otherwise. 
public static bool operator false(DBBool x) 


return x.value > 0; 


: return x.value < 0; 

RA override bool Equals(object obj) 

: if (!(0bj is DBBool)) return false; 
return value == ((DBBool)obj).value; 

abies override int GetHashCode( ) 

: return value; 

pubic override string ToString() 


if (value » 0) return "DBBool.True"; 


if (value « 0) return "DBBool.False"; 
return "DBBool.Null"; 


j 


«| = 








重 载 true 和 false 运算 符 的 类 型 可 以 用 于 if、do、while 和 for 语句 以 及 条 件 表 达 
式 中 的 控制 表达 式 。 


如 果 类 型 定义 了 false 运算 符 ， 则 它 还 必须 定义 true 运算 符 。 
类 型 不 能 直接 重 载 条 件 逻 辑 运 算 符 && 和 ||， 但 通过 重 载 正则 逻辑 运算 符 以 及 运算 


符 true 与 false 可 以 达到 同样 的 效果 。 
C# i Tua $m SE 
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CH 运算 符 

true (C£ 参考 ) 


false 字面 常数 (C4 参考 ) 


表示 布尔 值 false。 


class TestClass 


{ 
static void Main() 
{ 
bool a = false; 
Console.WriteLine( a ? "yes" : "n 
} 


} 
// Output: no 


CH iE 


有 关 详 细 信 息 ， we $2] C# i je 言 规范 。 该 语 言 规范 Jb 2L 


请 参阅 

C# 参考 

C 编程 指南 
C# 关键 字 

true (C£ 参考 ) 


si Jr 


是 C# 语法 和 用 法 的 权威 资 料 。 


stackalloc (CX 参考 ) 


stackalloc 关键 字 用 于 不 安全 的 代码 上 下 文中 ， 以 便 在 堆栈 上 分 配 内 存 块 。 


int* block = stackalloc int[100]; 


备注 
关键 字 仅 在 局 部 变量 的 初始 值 中 有 效 。 下 面 的 代码 导致 编译 器 错误 。 


int* block; 

// The following assignment statement causes compiler errors. You 
// can use stackalloc only when declaring and initializing a local 
// variable. 

block = stackalloc int[100]; 


4 — gh 


由 于 涉及 指针 类 型 ， 因 此 stackalloc 要 求 不 安全 上 下 文 。 有 关 更 多 信息 ， 请 参见 
不 安全 代码 和 指针 (CH 编程 指南 ) o 


stackalloc 类 似 于 C 运行 库 中 的 _alloca。 


以 下 代码 示例 计算 并 演示 Fibonacci 序列 中 的 前 20 个 数字 。 每 个 数字 是 先前 两 个 
数字 的 和 。 在 代码 中 ， 大 小 足够 容纳 20 个 int 类 型 元 素 的 内 存 块 是 在 堆栈 上 分 配 
的 ， 而 不 是 在 堆 上 分 配 的 。 该 块 的 地 址 存储 在 fb 指针 中 。 此 内 存 不 受 垃 圾 回收 的 
制约 ， 因 此 不 必 交 其 生 住 (通过 使 用 fixed) 。 内 存 块 的 生存 期 受 限 于 定义 它 的 方法 
的 生存 期 。 不 能 在 方法 返回 之 前 释放 内 存 。 


class Test 


{ 
static unsafe void Main() 
{ 
const int arraySize = 20; 
int* fib = stackalloc int[arraySize]; 
int* p = fib; 
// The sequence begins with 1, 1. 
*p++ = *p++ = 1; 
for (int i = 2; i < arraySize; ++i, ++p) 
{ 
// Sum the previous two numbers. 
; Sa opI Spr 
for (int i = 0; i < arraySize; ++i) 
{ 
Console.WriteLine(fib[i]); 
} 
// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 
} 
} 
yel 
Output 
al 
1 
2 
3 
5 
8 
13 
21 
34 
55 
89 
144 
233 
377 
610 
987 
1597 
2584 
4181 
6765 
974 


不 安全 代码 的 安全 性 低 于 安全 替代 代码 。 但 是 ， 通 过 使 用 stackalloc 可 以 自动 启用 
公共 语言 运行 时 (CLR) PHA HRA WIRE. MRE MSRM, we 
尽快 终止 ， 以 最 大 限度 地 减 小 执行 恶意 代码 的 机 会 。 


CH 语言 规 泄 
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运算 符 关 键 字 〈C# 参考 ) 

不 安全 代码 和 指针 (CH 编程 指南 ) 


nameof (C# #0 Visual Basic 引用 ) 


用 于 获取 变量 、 类 型 或 成 员 的 简单 GRE) 字符 串 名 称 。 当 报告 代码 中 的 错误 、 
圭 接 " 模 型 -视图 -控制 器 "(MVC) 链接 、 触 发 属性 更 改 事件 等 时 ， 通 常 希望 捕获 方法 
的 字符 串 名 称 。 使 用 nameof 有 助 于 在 重 命 名 定义 时 使 代码 始终 有 效 。 在 必须 使 用 
字符 串 来 引用 定义 之 前 (在 重 命 名 代码 元 素 时 ， 此 操作 很 脆弱 ， 因 为 工具 不 知道 要 
检查 这 些 字符 串 ) 。 


nameof 表达 式 具 有 此 形式 : 


if (x -- null) throw new ArgumentNullException(nameof(x)); 
WriteLine(nameof(person.Address.ZipCode)); // prints "ZipCode" 


天 键 用 例 


这 些 示例 显示 nameof 的 关键 用 例 。 


void f(string s) { 
if (s == null) throw new ArgumentNullException(nameof(s)); 
} 


MVC 操作 链接 : 
<a>HTML</a> 


&lt;%= Html.ActionLink("Sign up", 
Qtypeof (UserController), 
Qnameof (UserController.SignUp)) 
%&Qt ; 


INotifyPropertyChanged : 


int p ( 

get { return this.p; } 

set { this.p = value; PropertyChanged(this, new PropertyChangec 
j 


«| — Ju 








XAML 依赖 项 属性 : 


public static DependencyProperty AgeProperty = DependencyProperty.t 
‘| — # 








日 志 记 录 : 


void f(int i) { 
Log(nameof(f), "method entry"); 
j 


特性 : 


[DebuggerDisplay("-(" + nameof(GetString) + "()}")] 
class C { 

string GetString() { } 
} 


示例 
一 些 C# 示例 : 


using Stuff = Some.Cool.Functionality 

class C { 
static int Methodi (string x, int y) {} 
static int Method1 (string x, string y) {} 
int Method2 (int z) (3 
string f<T>() => nameof(T); 


j 


var c - new C() 


nameof(C) -» "c" 

nameof(C.Method1) -> "Methodi" 

nameof(C.Method2) -» "Method2" 

nameof(c.Method1) -> "Methodi" 

nameof(c.Method2) -» "Method2" 

nameof(z) -> "z" // inside of Method2 ok, inside Methodi is a comp: 
nameof(Stuff) - "Stuff" 

nameof(T) -» "T" // works inside of method but not in attributes or 
nameof(f) -» "f" 

nameof(f<T>) -> syntax error 

nameof(f<>) -» syntax error 

nameof(Method2()) -» error "This expression does not have a name" 








上 面 的 很 多 示例 都 适用 于 Visual Basic。 下 面 是 一 些 特 定 的 Visual Basic 示例 : 


VB 


NameOf(a!Foo) -> ' error "This expression does not have a name" 
NameOf(dict("Foo")) -> ' error "This expression does not have a n: 
NameOf(dict.Item("Foo")) -» ' error "This expression does not have 
NameOf(arr(2)) -> ' error "This expression does not have a name": 
Dim x - Nothing 

NameOf(x.ToString(2)) -> ' error "This expression does not have a 
Dim o - Nothing 

NameOf(o.Equals) -» ' result "Equals". Warning: "Access of static 


‘ =a 
备注 


nameof 的 参数 必须 是 简单 名 称 、 限 定名 称 、 成 员 访问 、 指 定 成 员 的 基 访 问 或 指定 
成 员 的 此 类 访问 。 参 数 表 达 式 标 识 代码 定义 ， 但 从 不 进行 计算 。 


因为 在 语法 上 参数 必须 为 表达 式 ， 因 此 有 很 多 禁用 内 容 无 需 列 出 。 以 下 内 容 会 产生 
未 








错误 ， 值 得 一 提 : 预定 义 的 类 型 (如 int 或 void) 、 可 以 为 null 的 类 型 
(Point?) 、 数 组 类 型 (Customer[,]) 、 指 针 类 型 (Buffer*)、 限 定 别名 (A::B)、 
绑 定 的 泛 型 类 型 (Dictionary<,>)、 预 处 理 符号 (DEBUG) 和 标签 (loop:)。 
如 果 需 要 获取 完全 限定 名 ， 可 以 将 typeof 表达 式 和 nameof 结 合 使 用 。 


在 这 些 示 例 中 ， 显 示 了 可 使 用 类 型 名 称 并 访问 实例 方法 名 称 。 按 照 计 算 表达 式 的 要 
求 ， 无 需 具 有 类 型 的 实例 。 在 某 些 情况 下 使 用 类 型 名 称 非常 方便 ， 因 为 只 引用 名 称 
而 不 使 用 实例 数据 ， 因 此 不 必 构 建 实例 变量 或 表达 式 。 


你 可 以 引用 类 中 特性 表达 式 的 类 成 员 。 
没有 任何 方法 可 以 获取 租 人 “Method1 (str, str)* 等 签名 信息 。 实 现 该 操作 的 一 种 方法 


是 使 用 表达 式 Expression e = () => A.B.Method1("s1", "s2")， 并 从 生成 的 表达 式 树 
中 拉 取 Memberlnfo, 


有 关 详 细 人 信息， 请 参阅 CH 话 言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
有 关 详 细 信 息 ， 请 参阅 Visual Basic 语言 参考 。 
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Visual Basic 语言 参考 


Visual Basic 编程 指南 


nameof (C# 和 Visual Basic 引用 ) 874 


转换 关键 字 (CH 参考 ) 


本 节 描述 在 类 型 转换 中 使 用 的 关键 字 : 
e explicit 
e implicit 
e operator 

请 参阅 

C4 参考 


C# 编程 指南 
C# 关键 字 


explicit (C£ 参考 ) 


explicit 关键 字 用 于 声明 必须 使 用 强制 转换 来 调用 的 用 户 定义 的 类 型 转换 运算 符 。 
例如 ， 在 下 面 的 示例 中 ， 此 运算 符 将 名 为 Fahrenheit 的 类 转换 为 名 为 Celsius 的 
类 : 


// Must be defined inside a class called Fahrenheit: 
public static explicit operator Celsius(Fahrenheit fahr) 


return new Celsius((5.0f / 9.0f) * (fahr.degrees - 32)); 


可 以 如 下 所 示 调 用 此 转换 运算 符 : 


Fahrenheit fahr = new Fahrenheit(100.0f); 
Console.Write("(0) Fahrenheit", fahr.Degrees); 
Celsius c - (Celsius)fahr; 


转换 运算 符 将 源 类 型 转换 为 目标 类 型 。 源 类 型 提供 转换 运算 符 。 与 隐 式 转换 不 同 ， 
必须 通过 强制 转换 的 方式 来 调用 显 式 转换 运算 符 。 如 果 转 换 操 作 可 能 导致 异常 或 去 
失信 息 ， 则 应 将 其 标记 为 explicit。 这 可 以 防止 编译 器 无 提示 地 调用 可 能 产生 无 法 
预见 后 果 的 转换 操作 。 


省 略 此 强制 转换 将 导致 编译 时 错误 CS0266。 
有 关 更 多 信息 ， 请 参见 使 用 转换 运算 符 (CH 编程 指南 ) o 


下 面 的 示例 提供 Fahrenheit 和 Celsius 类 ， 它 们 中 的 每 一 个 都 为 另 一 个 提供 显 式 转 


换 运 算 符 。 


class Celsius 


{ 
public Celsius(float temp) 


{ 
} 


public static explicit operator Fahrenheit(Celsius c) 


( 


degrees - temp; 


return new Fahrenheit((9.0f / 5.0f) * c.degrees + 32); 


public float Degrees 
{ 


} 


private float degrees; 


get { return degrees; } 


} 


class Fahrenheit 


{ 
public Fahrenheit(float temp) 


( 


degrees - temp; 


// Must be defined inside a class called Fahrenheit: 
public static explicit operator Celsius(Fahrenheit fahr) 


{ 
return new Celsius((5.0f / 9.0f) * (fahr.degrees - 32)); 


public float Degrees 
f 


} 


private float degrees; 


get { return degrees; } 


} 


class MainClass 
{ 
static void Main() 
{ 
Fahrenheit fahr = new Fahrenheit(100.0f); 
Console.Write("{0} Fahrenheit", fahr.Degrees); 
Celsius c = (Celsius)fahr; 


Console.Write(" = {0} Celsius", c.Degrees); 
Fahrenheit fahr2 = (Fahrenheit)c; 
Console.WriteLine(" = {0} Fahrenheit", fahr2.Degrees); 


} 
} 
// Output: 
// 100 Fahrenheit = 37.77778 Celsius = 100 Fahrenheit 


下 面 的 示例 定义 一 个 结构 Digit， 该 结构 表示 单个 十 进 制 数字 。 定 义 了 一 个 运算 符 ， 
ED byte 转换 为 Digit， 但 因为 并 非 所 有 字 节 都 可 以 转换 为 Digit, BrELix £e 
显 式 的 


Struct Digit 


{ 
byte value; 
public Digit(byte value) 
if (value > 9) 
throw new ArgumentException(); 
this.value - value; 
} 
// Define explicit byte-to-Digit conversion operator: 
public static explicit operator Digit(byte b) 
{ 
Digit d = new Digit(b); 
Console.WriteLine("conversion occurred"); 
return d; 
} 
} 
class ExplicitTest 
{ 
static void Main() 
{ 
try 
byte b = 3; 
Digit d = (Digit)b; // explicit conversion 
catch (Exception e) 
Console.WriteLine("{0} Exception caught.", e); 
} 
} 
} 
J* 
Output: 
conversion occurred 
Be 
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如 何 : 在 结构 间 实 现 用 户 定义 的 转换 (C# 编程 指南 ) 
链接 的 用 户 定义 的 显 式 转换 在 C# 
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implicit (C£ 参考 ) 


implicit 2 bts Tr Are AEN E Bae AGE NER, 如 果 可 以 确保 转换 过 程 
会 造成 数据 丢失 ， 则 可 使 用 该 关键 字 在 用 户 定义 类 型 和 其 他 类 型 之 间 进 行 隐 式 转 
B. 


class Digit 


{ 
public Digit(double d) { val = d; } 
public double val; 
// ...other members 
// User-defined conversion from Digit to double 
public static implicit operator double(Digit d) 
{ 
return d.val; 
// User-defined conversion from double to Digit 
public static implicit operator Digit(double d) 
{ 
return new Digit(d); 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
Digit dig = new Digit(7); 
//This call invokes the implicit "double" operator 
double num = dig; 
//This call invokes the implicit "Digit" operator 
Digit dig2 = 12; 
Console.WriteLine("num = {0} dig2 = {1}", num, dig2.val); 
Console.ReadLine(); 
} 
} 


EES M 


隐 式 转换 可 以 通过 消除 不 必要 的 类 型 转换 来 提高 源 代 码 的 可 读 性 。 但 是 ， 因 为 隐 式 
转换 不 需要 程序 员 将 一 种 类 ae 另 一 种 类 型 ， 所 以 使 用 隐 式 转换 时 必 
须 格 外 小 心 ， 以 免 出 现 意外 结 一 般 情 况 下 ， 隐 式 转换 运算 符 应 当 从 不 引发 异常 
并 且 从 不 丢失 信息 ， eae. 不 知晓 的 情况 下 安全 使 用 它 Els Li ee 
2 uem 条 件 ， 则 应 将 其 标记 为 explicit。 有 关 更 多 信息 ， 请 参见 使 用 转 
din 
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有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

C# 编程 指南 

CH 关键 字 

explicit (C£ 参考 ) 

运算 符 (C# 参考 ) 

如 何 : 在 结构 间 实 现 用 户 定 义 的 转换 (C# 编程 指南 ) 


implicit (C# 参考 ) 


881 


运算 符 (C# 参考 ) 


使 用 operator 关键 字 来 重 载 内 置 运 算 符 ， 或 提供 类 或 结构 声明 中 的 用 户 定义 转 

换 。 

下 面 是 一 个 非常 简化 的 表示 分 数 的 类 。 该 类 重 载 了 + 和 * 运算 符 ， 以 执行 分 数 加 法 
和 乘法 ; 同时 提供 了 将 Fraction 类 型 转换 为 double 类 型 的 转换 运算 符 。 


class Fraction 


{ 
int num, den; 
public Fraction(int num, int den) 
{ 
this.num = num; 
this.den = den; 
J 
// overload operator + 
public static Fraction operator +(Fraction a, Fraction b) 
{ 
return new Fraction(a.num * b.den + b.num * a.den, 
a.den * b.den); 
} 
// overload operator * 
public static Fraction operator *(Fraction a, Fraction b) 
{ 
return new Fraction(a.num * b.num, a.den * b.den); 
} 
// user-defined conversion from Fraction to double 
public static implicit operator double(Fraction f) 
{ 
return (double)f.num / f.den; 
} 
} 
class Test 
{ 
static void Main() 
{ 
Fraction a = new Fraction(1, 2); 
Fraction b = new Fraction(3, 7); 
Fraction c = new Fraction(2, 3); 
Console.WriteLine((double)(a * b + c)); 
} 
} 
VES 
Output 
0.880952380952381 
2 


规范 是 C# 语法 和 用 法 的 权威 资料 。 


MSDN C# 编程 指南 & 参考 手册 2015 


请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

implicit (C£ 参考 ) 

explicit (C£ 参考 ) 

如 何 : 在 结构 间 实 现 用 户 定义 的 转换 (CH 编程 指南 ) 


运算 符 (CH 参考 ) 884 


访问 关键 字 (C# 参考 ) 


本 节 介 绍 下 列 访问 关键 字 : 


e base 
访问 基 类 的 成 员 。 
e this 


引用 类 的 当前 实例 。 
请 参阅 
CH 参考 
C# 编程 指南 


访问 修饰 符 〈C# 参考 ) 
C# 关键 字 


base (C4 2) 


base 关键 字 用 于 从 派生 类 中 访问 基 类 的 成 员 : 

。 调用 基 类 上 已 被 其 他 方法 重 写 的 方法 。 

e 指定 创建 派生 类 实例 时 应 调用 的 基 类 构造 画 数 。 

类 访问 只 能 在 构造 男 数 、 实 例 方法 或 实例 属性 访问 器 中 进行 。 
从 静态 方法 中 使 用 base 关键 字 是 错误 的 。 


所 访问 的 基 类 是 类 声明 中 指定 的 基 类 。 例 如 ， 如 果 指 定 class ClassB : ClassA, 2 
无 论 ClassA 的 基 类 如 何 ， 从 ClassB 上 访问 ClassA 的 成 员 。 


在 本 例 中 ， 基 类 Person 和 派生 类 Employee 都 有 一 个 名 为 Getinfo 的 方法 。 通 过 
使 用 base 关键 字 ， 可 以 从 派生 类 中 调用 基 类 的 Getinfo 方法 。 


public class Person 


{ 
protected string ssn = "444-55-6666"; 
protected string name = "John L. Malgraine"; 
public virtual void GetInfo() 
{ 
Console.WriteLine("Name: {0}", name); 
Console.WriteLine("SSN: {0}", ssn); 
} 
} 
class Employee : Person 
{ 
public string id = "ABC567EFG"; 
public override void GetInfo() 
// Calling the base class GetInfo method: 
base.GetInfo(); 
Console.WriteLine("Employee ID: {0}", id); 
} 
} 
class TestClass 
{ 
static void Main() 
{ 
Employee E = new Employee(); 
E.GetInfo(); 
} 
} 
Vas 
Output 


Name: John L. Malgraine 
SSN: 444-55-6666 
Employee ID: ABC567EFG 
tf 


有 关 其 他 示例 ， 请 参见 new、virtual 和 override, 


本 示例 显示 如 何 指定 在 创建 派生 类 实例 时 调用 的 基 类 构造 西数 。 


public class BaseClass 


{ 
int num; 
public BaseClass() 
{ 
Console.WriteLine("in BaseClass()"); 
} 
public BaseClass(int i) 
{ 
num = i; 
Console.WriteLine("in BaseClass(int i)"); 
} 
public int GetNum() 
{ 
return num; 
} 
} 
public class DerivedClass : BaseClass 
{ 
// This constructor will call BaseClass.BaseClass() 
public DerivedClass() : base() 
{ 
} 
// This constructor will call BaseClass.BaseClass(int i) 
public DerivedClass(int i) : base(i) 
{ 
} 
static void Main() 
{ 
DerivedClass md = new DerivedClass(); 
DerivedClass mdi = new DerivedClass(1); 
} 
} 
Vas 
Output: 


in BaseClass() 
in BaseClass(int i) 


有 关 详 细 信 息 ， 请 参阅 C# 语 羊 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
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请 参阅 

C# 参考 

CH 编程 指南 
C# 关键 字 
this (C£ 参考 ) 


base (CH 参考 ) 


889 


this (CX 2) 
this 关键 字 引 用 类 的 当前 实例 ， 还 可 用 作 扩 展 方法 的 第 一 个 参数 的 修饰 符 。 


8 注意 
本 文 讨论 对 类 实例 使 用 this。 有 关 其 在 扩展 方法 中 使 用 的 更 多 信息 ， 请 参见 扩 
展 方 法 (CH 编程 指南 ) 。 


以 下 是 this 的 常用 用 途 : 
e 限定 被 相似 的 名 称 隐藏 的 成 员 ， 例 如 : 


public Employee(string name, string alias) 
// Use this to qualify the fields, name and alias: 


this.name = name; 
this.alias - alias; 


e 将 对 象 作为 参数 传递 到 其 他 方法 ， 例 如 : 


CalcTax(this); 


e 声明 索引 器 ， 例 如 : 


public int this[int param] 


get { return array[param]; } 
set { array[param] = value; } 


AFR SR AEF E — 4, FHARSHRN—BO, As this HH. TE 
静态 方法 中 引用 this 是 错误 的 。 


在 本 例 中 ，this 用 于 限定 Employee 类 成 员 name 和 alias， 它 们 都 被 相似 的 名 称 
隐藏 。 该 关键 字 还 用 于 将 对 象 传递 到 属于 其 他 类 的 方法 CalcTax。 


class Employee 
private string name; 


private string alias; 
private decimal salary - 3000.00m; 


// Constructor: 
public Employee(string name, string alias) 


x 
// Use this to qualify the fields, name and alias: 
this.name - name; 
this.alias - alias; 

} 


// Printing method: 
public void printEmployee() 


{ 
Console.WriteLine("Name: {0}\nAlias: {1}", name, alias); 
// Passing the object to the CalcTax method by using this: 
Console.WriteLine("Taxes: {0:C}", Tax.CalcTax(this)); 
j 
public decimal Salary 
{ 
get { return salary; } 
} 
} 
class Tax 
{ 
public static decimal CalcTax(Employee E) 
{ 
return 0.08m * E.Salary; 
} 
} 
class MainClass 
{ 
static void Main() 
{ 
// Create objects: 
Employee E1 = new Employee("Mingda Pan", "mpan"); 
// Display results: 
E1.printEmployee(); 
} 
} 
VES 
Output 


Name: Mingda Pan 
Alias: mpan 
Taxes: $240.00 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
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请 参阅 

C# 参考 

C# 编程 指南 

CH 关键 字 

base (C£ 参考 ) 
方法 (CH 编程 指南 ) 


this (C£ 参考 ) 


892 


文字 关键 子 (CH 参考 ) 


CH 有 下 列 文字 关 键 字 : 
e null 
e true 
e false 


e default 


请 参阅 
C4 参考 

C# 编程 指南 
CH 关键 字 


null (C£ 参考 ) 


null 关键 字 是 表示 不 引用 任何 对 象 的 null 引用 的 文字 值 。 null 是 引用 类 型 变量 的 
默认 值 。 普 通 值 类 型 不 能 为 null。 但 是 ，C# 2.0 引入 了 可 以 为 nul 值 的 类 型 。 请 参 
见 可 以 为 null 的 类 型 (C# 编程 指南 ) 。 


下 面 的 示例 演示 null 关键 字 的 一 些 行为 : 


class Program 


{ 

class MyClass 

{ 
public void MyMethod() { } 

} 

static void Main(string[] args) 

{ 
// Set a breakpoint here to see that mc = null. 
// However, the compiler considers it "unassigned." 
// and generates a compiler error if you try to 
// use the variable. 
MyClass mc; 
// Now the variable can be used, but... 
mc = null; 
fi . a method call on a null object raises 
// a run-time NullReferenceException. 
// Uncomment the following line to see for yourself. 
// mc.MyMethod(); 
// Now mc has a value. 
mc = new MyClass(); 
// You can call its method. 
mc.MyMethod(); 
// Set mc to null again. The object it referenced 
// is no longer accessible and can now be garbage-collectec 
mc - null; 
// A null string is not the same as an empty string. 
string s - null; 
string t = String.Empty; // Logically the same as "" 
// Equals applied to any null object returns false. 


bool b - (t.Equals(s)); 
Console.WriteLine(b); 


// Equality operator also returns false when one 
// operand is null. 
Console.WriteLine("Empty string (0j null string", s == t ? 


// Returns true. 
Console.WriteLine("null == null is {0}", null == null); 


// A value type cannot be null 
// int i - null; // Compiler error! 


// Use a nullable value type instead: 
int? i - null; 


// Keep the console window open in debug mode. 
System.Console.WriteLine("Press any key to exit."); 
System.Console.ReadKey(); 





CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 C# 语言 规 沁 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

文字 关键 字 〈C# 参考 ) 
默认 值 表 (CAS) 
Nothing (Visual Basic) 


default (C# 5#) 


default 关键 字 。 
default 关键 字 可 在 switch 话 句 或 泛 型 代码 中 使 用 。 
e switch 语句 : 指定 默认 标签 。 
e 泛 型 代码 : 指定 类 型 参数 的 默认 值 。 这 对 于 引用 类 型 为 null， 对 于 值 类 型 为 
请 参阅 
C# 参考 
C# 编程 指南 
C# 关键 字 


上 下 文 天 键 字 (CH 2) 


上 下 文 关键 字 用 于 提供 代码 中 的 特定 含义 ， 但 它 不 是 C# 中 的 保 
面 这 些 上 下 文 关键 字 : 


BI = 
FB To 


本 节 介 绍 下 


关键 字 说 明 
添加 NE eee 
async 指示 所 修改 的 方法 、 lambda 表达 式 或 匿名 方法 是 异步 的 。 
等 待 圭 起 异步 方法 ， 直 到 其 中 一 等 待 任务 完成 。 
dynamic 定义 一 个 引用 类 型 ， 实 现 发 生 绕 过 编译 时 类 型 检查 的 操作 。 
get 为 属性 或 素 引 器 定义 访问 器 方法 。 
global 指定 未 以 其 他 方式 命名 的 默认 全 局 命名 空间 。 
名 人 在 整个 同一 编译 单元 内 定义 分 部 类 、 结 构 和 接口 。 
UE 定义 一 个 自 定义 事件 访问 器 ， 客 户 端 代码 取消 订阅 事件 时 将 调用 
该 访问 十 。 
set 为 属性 或 索引 器 定义 访问 器 方法 。 
value 用 于 设置 访问 器 和 添加 或 移 除 事件 处 理 程 序 。 
var 使 编译 器 能 够 确定 在 方法 作用 域 中 声明 的 变量 的 类 型 。 
where 将 约束 添加 到 泛 型 声明 。 ( 另 请 参见 where). 
visti TER Cas tk AURA, AFARA ZU SOR fi R AR eim RIK 


o 


C£ 3.0 中 引入 的 所 有 查询 关键 字 也 都 是 上 下 文 相 关 的 。 有 关 更 多 信息 ， 请 参见 查 


询 关 键 字 (CH 参考 ) 。 


请 参阅 
CH 参考 

C# 编程 指南 
CH 关键 字 


add (C4 2) 


add 上 下 文 关键 字 用 于 定义 一 个 自 定义 事件 访问 器 ， 当 客户 端 代码 订阅 您 的 事件 时 
将 调用 该 访问 器 。 如 果 提 供 自 定义 add 访问 器 ， 还 必须 提供 remove 访问 器 。 


下 面 的 示例 演示 一 个 具有 自 定 义 add 和 remove 访问 器 的 事件 。 有 关 完 整 的 示例 ， 
请 参见 如 何 : 实现 接口 事件 (CH 编程 指南 ) o 


class Events : IDrawingObject 


{ 
event EventHandler PreDrawEvent; 
event EventHandler IDrawingObject .OnDraw 
{ 
add 
lock (PreDrawEvent ) 
{ 
PreDrawEvent += value; 
} 
} 
remove 
lock (PreDrawEvent) 
{ 
PreDrawEvent -= value; 
} 
} 
} 
} 


通常 不 需要 提供 自己 的 自 定义 事件 访问 器 。 在 大 多 数 情况 下 ， 使 用 在 声明 事件 时 由 
编译 器 自动 生成 的 访问 器 就 足够 了 。 


请 参阅 


事件 (CH 编程 指南 ) 


get (Ct 参考 ) 


get 关键 字 在 属性 或 素 引 器 中 定义 访问 器 方法 ， 以 检索 该 属性 或 该 索引 器 元 素 的 
值 。 有 关 更 多 信息 ， 请 参见 属性 (CH 编程 指南 ) 、 自 动 实现 的 属性 (CH 编程 指 
南 ) 和 索引 器 (CH 编程 指南 ) o 


下 面 的 示例 是 名 为 Seconds 的 属性 中 的 get 访问 器 : 


class TimePeriod 
private double seconds; 


public double Seconds 


{ 
get { return _seconds; } 
set { seconds = value; } 


下 面 的 示例 是 自动 实现 的 属性 中 的 get 访问 器 : 


class TimePeriod2 


public double Hours ( get; set; j 


CH EAR 

有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 

C4 参考 


C 编程 指南 
C# 关键 字 


global (C£ 参考 ) 


在 :: 运算 符 前 面 使 用 的 global 上 下 文 关键 字 引用 全 局 命名 空间 ， 该 命名 空间 是 任 
何 CH 程序 的 黑 认 命名 空间 ， 未 以 其 他 方式 命名 。 有 关 更 多 信息 ， 请 参见 如 何 : 使 
用 全 局 命名 空间 别名 (CH 编程 指南 ) o 


下 面 的 示例 演示 如 何 使 用 global 上 下 文 关键 字 指 定 在 全 局 命名 空间 中 定义 TestApp 


ss 
R 


class TestClass : global::TestApp { } 


请 参阅 


命名 空间 (C# 编程 指南 ) 


分 部 〈 类 型 ) (CH 参考 ) 


分 部 类 型 定义 允许 将 类 、 结 构 或 接口 的 定义 拆 分 到 多 个 文件 中 。 
在 File1.cs 中 : 
namespace PC 
partial class A 
int num = 0; 


void MethodA() { } 
partial void MethodC(); 


在 File2.cs 中 ， 声 明 : 


namespace PC 


{ 
partial class A 
{ 
void MethodB() { } 
partial void MethodC() { } 
j 


备注 

当 使 用 大 项 目 或 自动 生成 的 代码 (如 由 提供 的 代码 ) 时 ， 将 一 个 类 、 结 构 或 接口 类 
型 拆 分 到 多 个 文件 中 的 做 法 就 很 有 用 。3c3d61f8-f36c-4d41-b9c3-398376fabb15 分 
部 类 型 可 能 包含 分 部 方法 。 有 关 更 多 信息 ， 请 参见 分 部 类 和 方法 (CH 编程 指 

南 ) 。 


C# 2 BAU 
有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
请 参阅 


C# 参考 
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CH 编程 指南 
修饰 符 (CR 参考 ) 
泛 型 介绍 (CH 编程 指南 ) 


分 部 (类型) (CH 参考 ) 902 


分 部 UR) (C# BA) 


分 部 方法 在 分 部 类 型 的 一 个 部 分 中 定义 它 的 签名 ， 并 在 该 类 型 的 另外 一 个 部 分 中 定 
义 它 的 实现 。 类 设计 人 员 可 以 使 用 分 部 方法 提供 由 开发 人 员 决 定 是 否 实现 的 方法 挂 
4j (类似 于 事件 处 理 程序 ) 。 如 果 开 发 人 员 没 有 提供 实现 ， 则 编译 器 会 在 编译 时 移 
除 签名 。 下 列 条 件 适 用 于 分 部 方法 : 

e 分 部 类 型 的 两 个 部 分 中 的 签名 必须 匹配 。 

e 方法 必须 返回 void. 

e 没有 人 允许 的 访问 修饰 符 。 分 部 方法 是 隐 式 私有 的 。 
下 面 的 示例 演示 在 分 部 类 的 两 个 部 分 中 定义 的 分 部 方法 : 


namespace PM 


{ 
partial class A 
{ 
partial void OnSomethingHappened(string s); 
} 
// This part can be in a separate file. 
partial class A 
{ 
// Comment out this method and the program 
// will still compile. 
partial void OnSomethingHappened(String s) 
{ 
Console.WriteLine("Something happened: {0}", s); 
} 
} 
} 


有 关 详 细 信 息 ， 请 参阅 分 部 类 和 方法 (CH 编程 指南 ) 。 


请 参阅 
C# 参考 
分 部 (类 型 ) (C# 参考 ) 


remove (Cft 2) 

remove 上 下 文 关 键 字 用 于 定义 一 个 自 定 义 事件 访问 器 ， 当 客户 端 代码 取消 订阅 事 
件 时 将 调用 该 访问 器 。 如 果 提 供 自 定义 remove 访问 器 ， 还 必须 提供 add 访问 器 。 
示例 


下 面 的 示例 演示 一 个 具有 自 定 义 add 和 remove 访问 器 的 事件 。 有 关 完 整 的 示例 ， 
请 参见 如 何 : 实现 接口 事件 (CH 编程 指南 ) o 


class Events : IDrawingObject 
event EventHandler PreDrawEvent; 
event EventHandler IDrawingObject.OnDraw 
add 
lock (PreDrawEvent) 


PreDrawEvent += value; 


} 
remove 
lock (PreDrawEvent) 
{ 
PreDrawEvent -= value; 
} 
} 


通常 不 需要 提供 自己 的 自 定义 事件 访问 器 。 在 大 多 数 情况 下 ， 使 用 在 声明 事件 时 由 
编译 器 自动 生成 的 访问 器 就 足够 了 。 


M 


请 参见 


y 


考 
事件 (CH 编程 指南 ) 


set (C# 2X) 


set 关键 字 在 属性 或 索引 器 中 定义 为 该 属性 或 索引 器 元 素 赋 值 的 "访问 器 "方法 。 有 关 
详细 信息 和 示例 ， 请 参阅 属性 (CH 编程 指南 ) ， 自动 实现 的 属性 (CH 编程 指 
南 ) ， 和 索引 器 (CH 编程 指南 ) 。 


此 例 是 名 为 Seconds 的 属性 的 set 访问 器 : 


class TimePeriod 
private double seconds; 


public double Seconds 


{ 
get { return _seconds; } 
set { seconds = value; } 


下 面 的 示例 是 自动 实现 的 属性 中 的 set 访问 器 : 


class TimePeriod2 


public double Hours ( get; set; j 


CH 32 BASE 


有 关 详 细 信 息 ， 请 参阅 CHGRERRSGUUD. BSBA CH 语法 和 用 法 的 权威 资料 。 


请 参阅 

C# 参考 

C# 编程 指南 

C# 关键 字 

属性 (CH 编程 指南 ) 


where ( 泛 型 类 型 约束 ) (CH 参考 ) 


在 泛 型 类 型 定义 中 ，where 子 句 用 于 指定 对 下 列 类 型 的 约束 : 这 些 类 型 可 用 作 泛 型 
声明 中 定义 的 类 型 参数 的 实 参 。 例如 ， 可 以 声明 一 个 泛 型 类 MyGenericClass， 这 
样 ， 类 型 参数 T 就 可 以 实现 IComparable<T> 接口 : 


public class MyGenericClass<T> where T:IComparable ( } 


3 
Ef TER 


有 关 查 询 表 达 式 中 的 where 子 句 的 更 多 信息 ， 请 参见 where 3] (CZ 
考 


o 


除了 接口 约束 ，where 子 句 还 可 以 包括 基 类 约束 ， 以 指出 茶 个 类 型 必须 将 指定 的 类 
人 (或 者 就 是 该 类 本 身 ) ， 才 能 用 作 该 泛 型 类 型 的 类 型 参数 。 这 样 的 约束 一 
经 使 用 ， 就 必须 出 现在 该 类 型 参数 的 所 有 其 他 约束 之 前 。 


class MyClass<T, U> 
where T : class 
where U : struct 


{} 


where Tie e EAM MS ER (MR, 可 以 使 用 new 运算 符 创 建 类 型 参数 的 实 
fill ; 但 类 型 参数 为 此 必须 受 构造 画 数 约束 new() 的 约束 。 new() 约束 可 以 让 编译 器 
知道 提供 的 任何 类 型 参数 都 必须 具有 可 访问 的 无 参数 (或 默认 ) Mise. Fill 
如 : 


public class MyGenericClass<T> where T : IComparable, new() 


// The following line is not possible without new() constraint 
T item - new T(); 


} 
-| 
new() 约束 出 现在 where 子 句 的 最 后 。 

对 于 多 个 类 型 参数 ， 每 个 类 型 参数 都 使 用 一 个 where 子 句 ， 例 如 : 


interface IMyInterface 
{ 
} 


class Dictionary<TKey, TVal> 
where TKey : IComparable, IEnumerable 
where TVal : IMyInterface 


{ 
public void Add(TKey key, TVal val) 
{ 
} 

} 


还 可 以 将 约束 附加 到 泛 型 方法 的 类 型 参数 ， 例 如 


public bool MyMethod<T>(T t) where T : IMyInterface { } 


请 注意 ， 对 于 委托 和 方法 两 者 来 说 ， 描 述 类 型 参数 约束 的 语法 是 一 样 的 : 
delegate T MyDelegate<T>() where T : new() 

有 关 泛 型 委托 的 信息 ， 请 参见 泛 型 委托 。 

有 关 约 束 的 语法 和 用 法 的 详细 信息 ， 请 参见 类 型 参数 的 约束 。 

CH 语言 规 泄 

有 关 详 细 信 息 ， 请 参阅 C# 语言 规 沁 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 

请 参阅 

C# 参考 

C# 编程 指南 

泛 型 介绍 (CH 编程 指南 ) 


new 约束 (CH 参考 ) 
类 型 参数 的 约束 (CH 编程 指南 ) 


value (C# 2) 


上 下 文 关 键 字 value 用 在 普通 属性 声明 的 set 访问 器 中 。 此 关键 字 类 似 于 方法 的 输 
和 参数。 关键 字 value 引用 客户 端 代码 尝试 赋 给 属性 的 值 。 在 下 面 的 示例 中 ， 
MyDerivedClass 有 一 个 名 为 Name 的 属性 ， 该 属性 使 用 value 参数 向 支持 字段 
name 分 配 新 字符 串 。 从 客户 端 代码 的 角度 来 看 ， 该 操作 写作 一 个 简单 的 赋值 语 


句 。 


class MyBaseClass 


{ 
// virtual auto-implemented property. Overrides can only 
// provide specialized behavior if they implement get and set : 
public virtual string Name { get; set; } 
// ordinary virtual property with backing field 
private int num; 
public virtual int Number 
{ 
get { return num; } 
set { num = value; } 
} 
} 
class MyDerivedClass : MyBaseClass 
{ 
private string name; 
// Override auto-implemented property with ordinary property 
// to provide specialized accessor behavior. 
public override string Name 
{ 
get 
{ 
return name; 
} 
set 
{ 
if (value != String.Empty) 
{ 
name = value; 
} 
else 
{ 
name = "Unknown"; 
} 
} 
} 
} 





有 关 使 用 value 的 更 多 信息 ， 请 参见 属性 (CH 编程 指南 ) 。 


CH EMI 


有 关 详 细 信 息 ， 请 参阅 C# EG. AAEE CH 语法 和 用 法 的 权威 资料 。 
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请 参阅 
C# 参考 

C# 编程 指南 
C# 关键 字 


value (C£ 参考 ) 910 


yield (C# 参考 ) 


如 果 你 在 语句 中 使 用 yield 关键 字 ， 则 意味 着 它 在 其 中 出 现 的 方法 、 运 算 符 或 get 
访问 器 是 迭代 器 。 通 过 使 用 yield 定义 迭代 器 ， 可 在 实现 自 定义 集合 类 型 的 
IEnumerable 和 IEnumerator 模式 时 无 需 其 他 显 式 类 (保留 榴 举 状态 的 类 ， 有 关 示 
例 ， 请 参阅 IEnumerator<T>) 。 

下 面 的 示例 演示 了 yield 语句 的 两 种 形式 。 


yield return «expression»; 
yield break; 


各 注 

使 用 yield return 语句 可 一 次 返回 一 个 元 素 。 

通过 foreach 语句 或 LINQ 查询 来 使 用 迭代 器 方法 。 foreach 循环 的 每 次 迭代 都 会 
调用 迭代 器 方法 。 和 迭代 器 方法 运行 到 yield return 语句 时 ， 会 返回 一 个 
expression， 并 保留 当前 在 代码 中 的 位 置 。 当下 次 调用 和 迭代 器 函数 时 执行 从 该 位 置 
重新 启动 。 

可 以 使 用 yield break 话 句 来 终止 迭代 。 


有 关 秋 代 器 的 详细 信息 ， 请 参阅 迭代 器 (C# 和 Visual Basic) o 
迭代 器 方法 和 get 访问 器 


迭代 器 的 声明 必须 满足 以 下 要 求 : 


e 返回 类 型 必须 为 IEnumerable, IEnumerable«T», IEnumerator 或 
IEnumerator<T>。 


e 该 声明 不 能 有 任何 ref 或 out https://msdn.microsoft.com/zh- 
CNilibrary/t3c3bfhx.aspx 参数 。 


返回 IEnumerable 或 IEnumerator 的 迭代 器 的 yield * Æ X object. Rik AIR 
E] |Enumerable<T> 或 IEnumerator<T>， 则 必须 将 yield return 语句 中 的 表达 式 
类 型 隐 式 转换 为 泛 型 类 型 参数 。 


你 不 能 在 具有 以 下 特点 的 方法 中 包含 yield return 或 yield break 语句 : 
。 匿名 方法 。 有 关 详 细 信 息 ， 请 参阅 匿名 方法 (CH 编程 指南 ) o 
e 包含 不 安全 的 块 的 方法 。 有 关 详 细 信 息 ， 请 参阅 unsafe (CE 参考 ) 。 


异常 处 理 


不 能 将 yield return ji try-catch 块 中 。 可 将 yield return 语句 置 于 try- 
finally 语句 的 try 块 中 。 


yield break 语句 可 以 位 于 try 块 或 catch 块 ， 但 不 能 位 于 finally 块 。 


如 果 foreach 主体 (在 迭代 器 方法 之 外 ) 引发 异常 ， 则 将 执行 迭代 器 方法 中 的 
finally 块 。 


技术 实现 


以 下 代码 从 迭代 器 方法 返回 IEnumerable<string>， 然 后 通 万 其 元 素 。 


IEnumerable«string» elements = MyIteratorMethod(); 
foreach (string element in elements) 


{ 
} 


调用 MylteratorMethod 并 不 执行 该 方法 的 主体 。 相 反 ， 该 调用 会 将 
IEnumerable<string> 返回 到 elements 变量 中 。 


在 foreach 循环 迭代 时 ， 将 为 elements 调用 MoveNext 方法 。 此 调用 将 执行 
MylteratorMethod 的 主体 ， 直 至 到 达 下 一 个 yield return 语句 。 yield return 语句 
返回 的 表达 式 不 仅 决定 了 循环 体 使 用 的 element 变量 值 ， 还 决定 了 元 素 的 Current 
属性 ( 它 是 IEnumerable<string>) 。 


在 foreach 循环 的 每 个 后 续 和 迭代 中 ， 和 迭代 器 主体 的 执行 将 从 它 暂 停 的 位 置 继 续 ， 直 
至 到 达 yield return 语句 后 才 会 停止 。 在 到 达 和 迭代 器 方法 的 结尾 或 yield break ;& 
句 时 ，foreach 循环 便 已 完成 。 


下 面 的 示例 包含 一 个 位 于 for 循环 内 的 yield return 语句 。 Process 中 的 foreach 
语句 体 的 每 次 迭代 都 会 创建 对 Power 迭代 器 函数 的 调用 。 对 迭代 器 函数 的 每 个 调用 
将 继续 到 yield return 语句 的 下 一 次 执行 〈 在 for 循环 的 下 一 次 迭代 期 间 发 生 ) 。 
迭代 器 方法 的 返回 类 型 是 |Enumerable (一 种 迭代 器 接口 类 型 ) 。 当 调用 迭代 器 方 
法 时 ， 它 将 返回 一 个 包含 数字 款 的 可 枚 举 对 象 。 


public class PowersOf2 


{ 
static void Main() 
// Display powers of 2 up to the exponent of 8: 
foreach (int i in Power(2, 8)) 
{ 
Console.write("(0) ", i); 
j 
} 
public static System.Collections.Generic.IEnumerable<int> Powe! 
{ 
int result = 1; 
for (int i = 0; i < exponent; i++) 
{ 
result = result * number; 
yield return result; 
} 
} 
// Output: 2 4 8 16 32 64 128 256 
} 


SSS 44) 5. 7B 


下 面 的 示例 演示 一 个 作为 迭代 器 的 get 访问 器 。 在 该 示例 中 ， 每 个 yield return 语 
名 返回 一 个 用 户 定义 的 类 的 实例 。 





public static class GalaxyClass 


( 


public static void ShowGalaxies() 


{ 
var theGalaxies = new Galaxies(); 
foreach (Galaxy theGalaxy in theGalaxies.NextGalaxy ) 
{ 
Debug.WriteLine(theGalaxy.Name + " " + theGalaxy.MegaL: 
} 
} 
public class Galaxies 
{ 
public System.Collections.Generic.IEnumerable«Galaxy» Next( 
{ 
get 
t 
yield return new Galaxy ( Name = "Tadpole", MegaLic 
yield return new Galaxy ( Name - "Pinwheel", MegaL: 
yield return new Galaxy ( Name = "Milky Way", Megal 
yield return new Galaxy ( Name - "Andromeda", Megal 
} 
} 
} 
public class Galaxy 
{ 
public String Name { get; set; } 
public int MegaLightYears { get; set; } 
} 





有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 


请 参阅 


C# 参考 

C# 编程 指南 

foreach, in (C£ 参考 ) 
迭代 器 (C# 和 Visual Basic) 


查询 关键 字 (C# 参考 ) 


本 节 包 含 查询 表达 式 中 使 用 的 上 下 文 关键 字 。 


本 节 内 容 


T^) 


from 
where 
select 
group 
into 
orderby 
join 


let 


on 
equals 

by 
ascending 


descending 


请 参阅 


C# 关键 字 


说 明 
指定 数据 源 和 范围 变量 (类似 于 迭代 变量 ) 。 


根据 一 个 或 多 个 由 逻辑 “与 "和 逻辑 “或 "运算 符 (&& 或 |) 分 隔 的 
布尔 表达 式 得 选 源 元 素 。 


指定 当 执 行 查询 时 返回 的 序列 中 的 元 素 将 具有 的 类 型 和 形式 。 
按照 指定 的 键 值 对 查询 结果 进行 分 组 。 


提供 一 个 标识 符 ， 它 可 以 充当 对 join、group 或 select 子 句 的 结 
果 的 引用 。 


基于 元 素 类 型 的 默认 比较 器 按 升 序 或 降序 对 查询 结果 进行 排序 。 
基于 两 个 指定 匹配 条 件 之 间 的 相等 比较 来 联接 两 个 数据 源 。 
引入 一 个 用 于 存储 查询 表达 式 中 的 子 表达 式 结 果 的 范围 变量 。 
join 子 句 中 的 上 下 文 关键 字 。 

join 子 句 中 的 上 下 文 关键 字 。 

join 子 句 中 的 上 下 文 关键 字 。 

group 子 句 中 的 上 下 文 关键 字 。 

orderby 子 句 中 的 上 下 文 关 键 字 。 

orderby 子 句 中 的 上 下 文 关 键 字 。 


LINQ (Language-Integrated Query) 
LINQ 查询 表达 式 (CH 编程 指南 ) 
Getting Started with LINQ in CZ 


from £4) (Ct 2) 


查询 表达 式 必须 以 from 子 句 开头 。 另 外 ， 查 询 表 达 式 还 可 以 包含 子 查询 ， 子 查询 
也 是 以 from 子 句 开头 。 from 子 句 指定 以 下 内 容 : 


e 将 对 其 运行 查询 或 子 查询 的 数据 源 。 
e 一 个 本 地 范围 变量 ， 表 示 源 序列 中 的 每 个 元 素 。 


范围 变量 和 数据 源 都 是 强 类 型 。 from 子 句 中 引用 的 数据 源 的 类 型 必须 为 
IEnumerable, IEnumerable«T» 或 一 种 派生 类 型 (如 IQueryable<T>) 。 


在 下 面 的 示例 中 ，numbers 是 数据 源 ， 而 num 是 范围 变量 。 请 注意 ， 这 两 个 变量 
都 是 强 类 型 ， 即 使 使 用 了 var 关键 字 也 是 如 此 。 


class LowNums 


( 


static void Main() 


( 


// A simple data source. 
int[] numbers = (5, 4, 1, 3, 9, 8, 6 7, 2, 0 }; 


// Create the query. 
// lowNums is an IEnumerable<int> 
var lowNums - from num in numbers 
where num « 5 
select num; 


// Execute the query. 
foreach (int i in lowNums) 


Console.Write(i + " "); 


j 


} 
// Output: 4132 0 


a+ jr EL 
>b A f= 


如 果 数 据 源 实现 了 IEnumerable<T>， 则 编译 器 可 以 推断 范围 变量 的 类 型 。 例 如 ， 
如 果 数 据 源 的 类 型 为 IEnumerable<Customer>， 则 推断 出 范围 变量 的 类 型 为 
Customer。 仅 当 数 据 源 是 非 泛 型 IEnumerable 类 型 (如 ArrayList) 时 ， 才 必须 显 
式 指 定数 据 源 类 型 。 有 关 更 多 信息 ， 请 参见 How to: Query an ArrayList with 
LINQ, 


在 上 一 个 示例 中 ，num 被 推断 为 int 类 型 。 由 于 范围 变量 是 强 类 型 ， 因 此 可 以 对 其 
调用 方法 或 者 在 其 他 操作 中 使 用 它 。 例 如 ， 可 以 不 编写 select num， 而 编写 select 
num.ToString() 使 查询 表达 式 返 回 一 个 字符 串 序 列 而 不 是 整数 序列 。 或 者 ， 也 可 以 
编写 select n + 10 使 表达 式 返 回 序列 14、11、13、12、10。 有 关 更 多 信息 ， 请 参 
X, select 子 句 (CH 参考 ) 。 


范围 变量 类 似 于 foreach 语句 中 的 迭代 变量 ， 只 是 两 者 之 间 有 一 个 非常 重要 的 区 
别 : 范围 变量 从 不 实际 存储 来 自 数 据 源 的 数据 。 范 围 变量 只 是 提供 了 语法 上 的 便 
利 ， 使 查询 能 够 描述 执行 查询 时 将 发 生 的 事情 。 有 关 更 多 信息 ， 请 参见 
Introduction to LINQ Queries (C£), 


复合 from 子 句 


在 某 些 情况 下 ， 源 序列 中 的 每 个 元 素 本 身 可 能 是 序列 ， 也 可 能 包含 序列 。 例 如 ， 数 
据 源 可 能 是 一 个 IEnumerable<Student>， 其 中 ， 序 列 中 的 每 个 Student 对 象 都 包 
含 一 个 测验 得 分 列表 。 若 要 访问 每 个 Student 元 素 中 的 内 部 列表 ， 可 以 使 用 复合 
from 子 句 。 该 技术 类 似 于 使 用 斤 套 的 foreach 语句 。 可 以 向 任 一 from 子 句 中 添加 
where 或 orderby 子 句 来 筛选 结果 。 下 面 的 示例 演示 了 一 个 Student 对 象 序 列 ， 其 
中 每 个 对 象 都 包含 一 个 表示 测验 得 分 的 内 部 整数 List。 为 了 访问 该 内 部 列表 ， 此 示 
例 使 用 了 复合 from 子 句 。 如 有 必要 ， 可 在 两 个 from 子 句 之 间 再 插 人 子 句 。 


class CompoundFrom 


// The element type of the data source. 
public class Student 


public string LastName ( get; set; ) 
public List<int> Scores (get; set;} 


} 


static void Main() 


( 


// Use a collection initializer to create the data source. 
// each element in the list contains an inner sequence of : 
List«Student» students - new List«Student» 


1 
new Student (LastName-"Omelchenko", Scores- new List<int 
new Student {LastName="0'Donnell", Scores- new List<int> 
new Student {LastName="Mortensen", Scores- new List<int> 
new Student {LastName="Garcia", Scores- new List<int> {f 
new Student {LastName="Beebe", Scores- new List<int> (3! 
J; 


// Use a compound from to access the inner sequence within 
// Note the similarity to a nested foreach statement. 
var scoreQuery = from student in students 
from score in student.Scores 
where score » 90 


select new ( Last - student.LastName, : 


// Execute the queries. 

Console.WriteLine("scoreQuery:"); 

// Rest the mouse pointer on scoreQuery in the following 1: 
// see its type. The type is IEnumerable<'a>, where 'a is ¢ 
// anonymous type defined as new {string Last, int score}. 
// each instance of this anonymous type has two members, a 
// (Last) and an int (score). 

foreach (var student in scoreQuery) 


{ 
} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


Console.WwriteLine("[0) Score: {1}", student.Last, stud: 


} 
} 
Vs 
scoreQuery: 


Omelchenko Score: 97 
O'Donnell Score: 91 
Mortensen Score: 94 
Garcia Score: 97 
Beebe Score: 91 


we 


Ne 





使 用 多 个 from 子 句 执行 联接 


复合 from 子 句 用 于 访问 单个 数据 源 中 的 内 部 集合 。 不 过 ， 查 询 还 可 以 包含 多 个 可 
从 独立 数据 源 生 成 补充 查询 的 from 子 句 。 使 用 此 技术 可 以 执行 某 些 类 型 的 、 无 法 
通过 使 用 join 子 句 执行 的 联接 操作 。 


下 面 的 示例 演示 如 何 使 用 两 个 from 子 句 构成 两 个 数据 源 的 完全 交叉 联接 。 


class CompoundFrom2 


( 


static void Main() 


D 


char[] upperCase 
char[] lowerCase 


= ( 'A', UB Gn pe 
DOO EM 
// The type of joinQuery1 is IEnumerable<'a>, where 'a 
// indicates an anonymous type. This anonymous type has tw 
// members, upper and lower, both of type char. 
var joinQuery1 = 
from upper in upperCase 
from lower in lowerCase 


select new { upper, lower }; 


// The type of joinQuery2 is IEnumerable<'a>, where 'a 
// indicates an anonymous type. This anonymous type has tw 
// members, upper and lower, both of type char. 
var joinQuery2 - 
from lower in lowerCase 
where lower !- 'x' 
from upper in upperCase 
select new { lower, upper }; 


// Execute the queries. 

Console.WriteLine("Cross join:"); 

// Rest the mouse pointer on joinQueryi to verify its type 
foreach (var pair in joinQuery1) 


{ 
} 


Console.WriteLine("Filtered non-equijoin:"); 
// Rest the mouse pointer over joinQuery2 to verify its ty; 
foreach (var pair in joinQuery2) 


{ 
} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


Console.WriteLine("{0} is matched to {1}", pair.upper, 


Console.WriteLine("{0} is matched to {1}", pair.lower, 


j 


/* Output: 
Cross join: 

is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
iltered non-equijoin: 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 
is matched to 


NX XNXXNXxXX 


*NNNECCETOOOUUU»DP—- 
QOwranyD 
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有 关 使 用 多 个 from 子 句 的 联接 操作 的 更 多 信息 ， 


作 (CH 编程 指南 ) o 


请 参阅 
查询 关键 字 (CH 参考 ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 


from #4) (CH 参考 ) 


请 参见 如 何 : 执行 自 定 义 联 接 操 


where +4) (CH 27) 


where 子 句 用 在 查询 表达 式 中 ， 用 于 指定 将 在 查询 表达 式 中 返回 数据 源 中 的 哪些 元 
素 。 它 将 一 个 布尔 条 件 (“谓词 ”) 应 用 于 每 个 源 元 素 (由 范围 变量 引用 ) ， 并 返回 
满足 指定 条 件 的 元 素 。 一 个 查询 表达 式 可 以 包含 多 个 Where 子 句 ， 一 个 子 句 可 以 
包含 多 个 谓词 子 表达 式 。 


在 下 面 的 示例 中 ，where 子 句 筛选 出 除 小 于 五 的 数字 外 的 所 有 数字 。 如 果 移 除 
where 子 句 ， 则 会 返回 数据 源 中 的 所 有 数字 。 表 达 式 num < 5 是 应 用 于 每 个 元 素 的 


谓词 。 


class WhereSample 


{ 
static void Main() 
f 
// Simple data source. Arrays support IEnumerable<T>. 
Int[] numbers = { 5, 4 1, 3, 9, 8, 6, 7, 2, O }; 
// Simple query with one predicate in where clause. 
var queryLowNums = 
from num in numbers 
where num < 5 
select num; 
// Execute the query. 
foreach (var s in queryLowNums ) 
Console.Write(s.ToString() + " "); 
} 
} 


//Output: 4132 0 


在 单一 where 子 句 内 ， 可 以 使 用 && 和 || 运算 符 根据 需要 指定 任意 多 个 谓词 。 在 
下 面 的 示例 中 ， 查 询 将 指定 两 个 谓词 ， 以 便 只 选择 小 于 五 的 偶数 。 


class WhereSample2 


X 
static void Main() 
{ 
// Data source. 
int[] numbers = { 5, 4, 1, 3, 9, 8, 6, 7, 2, O }; 
// Create the query with two predicates in where clause. 
var queryLowNums2 = 
from num in numbers 
where num < 5 && num % 2 == 
select num; 
// Execute the query 
foreach (var s in queryLowNums2) 
{ 
Console.Write(s.ToString() + " "); 
} 
Console.WriteLine(); 
// Create the query with two where clause. 
var queryLowNums3 = 
from num in numbers 
where num < 5 
where num % 2 == 
select num; 
// Execute the query 
foreach (var s in queryLowNums3) 
{ 
Console.Write(s.ToString() + " "); 
J 
Ji 
J 
// Output: 
7/4250 
//420 


where 子 句 可 以 包含 一 个 或 多 个 返回 布尔 值 的 方法 。 在 下 面 的 示例 中 ，where 子 句 
使 用 一 个 方法 来 确定 范围 变量 的 当前 值 是 偶数 还 是 奇数 。 


class WhereSample3 


( 


static void Main() 


// Data source 
int[] numbers = { 5, 4, 1, 3, 9, B, 6, 7; 2, 0 3; 


// Create the query with a method call in the where clause 
// Note: This won't work in LINQ to SQL unless you have a 
// stored procedure that is mapped to a method by this name 
var queryEvenNums - 

from num in numbers 

where IsEven(num) 

select num; 


// Execute the query. 
foreach (var s in queryEvenNums) 


{ 
} 


Console.Write(s.ToString() + " "); 


j 


// Method may be instance method or static method. 
static bool IsEven(int i) 


( 


return i % 2 == 0; 


} 


J 
//Output: 4 8 6 2 O 





备注 


where 子 句 是 一 种 第 选 机 制 。 除 了 不 能 是 第 一 个 或 最 后 一 个 子 句 外 ， 它 几乎 可 以 放 
在 查询 表达 式 中 的 任何 位 置 。 where 子 句 可 以 出 现在 group 子 句 的 前 面 或 后 面 ， 
具体 情况 取决 于 是 必须 在 对 源 元 素 进行 分 组 之 前 还 是 之 后 来 第 选 源 元 素 。 


如 果 指 定 的 谓词 对 于 数据 源 中 的 元 素 无 效 ， 则 会 发 生 编译 时 错误 。 这 是 LINQ 提供 
的 强 类 型 检查 的 一 个 优点 。 


编译 时 ，where 关键 字 会 被 转换 为 对 Where 标准 查询 运算 符 方法 的 调用 。 
请 参阅 
查询 关键 字 (CH 参考 ) 


from 子 句 (CH 参考 ) 
select 子 句 (C£ 参考 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


Filtering Data 
LINQ 查询 表达 式 (CH 编程 指南 ) 
Getting Started with LINQ in C# 


where £4) (CH 参考 ) 924 


select #7) (CH 27) 


FEA RAH, select 子 句 可 以 指定 将 在 执行 查询 时 产生 的 值 的 类 型 。 该 子 句 的 
结果 将 基于 前 面 所 有 子 句 的 计算 结果 以 及 select 子 句 本 身 中 的 所 有 表达 式 。 查 询 表 
达 式 必须 以 select FAR group 子 句 结 


下 面 的 示例 演示 了 坦 询 表达 式 中 的 简单 select 子 句 。 


class SelectSample1 
{ 


static void Main() 
{ 
//Create the data source 
List<int> Scores = new List<int>() { 97, 92, 81, 60 }; 


// Create the query. 
IEnumerable<int> queryHighScores = 
from score in Scores 
where score > 80 
select score; 


// Execute the query. 
foreach (int i in queryHighScores) 


Console.Write(i +" "); 


} 


} 
//Output: 97 92 81 


select 子 句 产生 的 序列 的 类 型 决定 了 查询 变量 queryHighScores 的 类 型 。 在 最 简单 
的 情况 下 ，select 子 句 仅 指定 范围 变量 。 这 会 使 返回 的 序列 包含 与 数据 源 具 有 相同 
类 型 的 元 素 。 有 关 更 多 信息 ， 请 参见 Type Relationships in LINQ Query Operations 
(C£), Ait, select 子 句 还 提供 了 一 种 功能 强大 的 机 制 ， 可 用 于 将 源 数据 转换 (或 
投影 ) 为 新 类 型 。 有 关 更 多 信息 ， 请 参见 Data Transformations with LINQ (C£), 
下 面 的 示例 演示 了 select 子 句 可 能 采用 的 所 有 不 同形 式 。 在 每 个 查询 中 ， 请 注意 
select 子 句 和 查询 变量 (studentQuery1、studentQuery2 等 ) 的 类 型 之 间 的 关 

Ro 


class SelectSample2 


// Define some classes 

public class Student 

{ 
public string First { get; set; } 
public string Last { get; set; } 


public int ID { get; set; } 
public List<int> Scores; 
public ContactInfo GetContactInfo(SelectSample2 app, ir 
{ 
ContactInfo cInfo = 
(from ci in app.contactList 
where ci.ID -- id 
select ci) 
.FirstOrDefault(); 


return cInfo; 


j 
public override string ToString() 
{ 
retlinnPLrst a Epa ast abo thse iy: 
j 
j 
public class ContactInfo 
{ 
public int ID { get; set; } 
public string Email { get; set; } 
public string Phone { get; set; } 
public override string ToString() { return Email + "," 
j 
public class ScoreInfo 
{ 
public double Average { get; set; } 
public int ID { get; set; ) 
j 


// The primary data source 
List«Student» students = new List<Student>() 


X 
new Student {First="Svetlana", Last="Omelchenko", ID-: 
new Student {First="Claire", Last="0'Donnell", ID-112, 
new Student {First="Sven", Last="Mortensen", ID-113, : 
new Student {First="Cesar", Last="Garcia", ID-114, Sc« 
J; 


// Separate data source for contact info. 

List<ContactInfo> contactList = new List<ContactInfo>() 

{ 
new ContactInfo {ID=111, Email-"'"SvetlanOQContoso.com", 
new ContactInfo {ID=112, Email="ClaireO@Contoso.com", | 
new ContactInfo {ID=113, Email="SvenMort@Contoso.com", 
new ContactInfo {ID=114, Email="CesarGar@Contoso.com", 


ia 


static void Main(string[] args) 


{ 


SelectSample2 app - new SelectSample2(); 


// Produce a filtered sequence of unmodified Students. 
IEnumerable«Student» studentQuery1 = 

from student in app.students 

where student.ID > 111 

select student; 


Console.WriteLine("Query1: select range variable"); 
foreach (Student s in studentQuery1) 
{ 


} 


Console.WriteLine(s.ToString()); 


// Produce a filtered sequence of elements that contair 
// only one property of each Student. 
IEnumerable«String» studentQuery2 = 

from student in app.students 

where student.ID » 111 

select student.Last; 


Console.WriteLine("NrNn studentQuery2: select range vai 
foreach (string s in studentQuery2) 


{ 
} 


Console.WriteLine(s); 


// Produce a filtered sequence of objects created by 
// a method call on each Student. 
IEnumerable«ContactInfo» studentQuery3 - 

from student in app.students 

where student.ID » 111 

select student.GetContactInfo(app, student.ID); 


Console.WriteLine("\r\n studentQuery3: select range vai 
foreach (ContactInfo ci in studentQuery3) 


i 
} 


// Produce a filtered sequence of ints from 
// the internal array inside each Student. 
IEnumerable<int> studentQuery4 = 

from student in app.students 

where student.ID > 111 

select student.Scores[0]; 


Console.WriteLine(ci.ToString()); 


Console.WriteLine("NrNn studentQuery4: select range vai 
foreach (int i in studentQuery4) 


{ 
} 


Console.WriteLine("First score = {0}", i); 


// Produce a filtered sequence of doubles 
// that are the result of an expression. 
IEnumerable«double» studentQuery5 = 

from student in app.students 

where student.ID > 111 

select student.Scores[0] * 1.1; 


Console.WriteLine("NrNn studentQuery5: select expressit 
foreach (double d in studentQuery5) 


{ 
} 


// Produce a filtered sequence of doubles that are 
// the result of a method call. 
IEnumerable<double> studentQuery6 = 

from student in app.students 

where student.ID > 111 

select student.Scores.Average(); 


Console.WriteLine("Adjusted first score = {0}", d), 


Console.WriteLine("\r\n studentQuery6: select expressit 
foreach (double d in studentQuery6) 


1 
} 


// Produce a filtered sequence of anonymous types 
// that contain only two properties from each Student. 
var studentQuery7 = 

from student in app.students 

where student.ID > 111 

select new { student.First, student.Last }; 


Console.WriteLine("Average = {0}", d); 


Console.WriteLine("NrNn studentQuery7: select new anon 
foreach (var item in studentQuery7) 


{ 
} 


// Produce a filtered sequence of named objects that cc 
// a method return value and a property from each Stude 
// Use named types if you need to pass the query varial 
// across a method boundary. 
IEnumerable«ScoreInfo» studentQuery8 = 

from student in app.students 

where student.ID » 111 

select new ScoreInfo 


( 


Console.WriteLine("([0), {1}", item.Last, item.Firs!i 


Average - student.Scores.Average(), 
ID - student.ID 


u 


Console.WriteLine("\r\n studentQuery8: select new name 


foreach (ScoreInfo si in studentQuery8) 


{ 
} 


Console.WriteLine("ID = {0}, Average = {1}", si.ID, 


// Produce a filtered sequence of students who appear « 
// and whose average is greater than 85. 
IEnumerable«ContactInfo» studentQuery9 - 

from student in app.students 

where student.Scores.Average() » 85 

join ci in app.contactList on student.ID equals ci 

select ci; 


Console.WriteLine("\r\n studentQuery9: select result o! 
foreach (ContactInfo ci in studentQuery9) 


{ 
} 


Console.writeLine("ID = {0}, Email = {1}", ci.ID, « 


// Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
j 

j 

/* Output 
Query1: select range variable 
Claire O'Donnell:112 


Sven Mortensen:113 
Cesar Garcia:114 


studentQuery2: select range variable.Property 
O'Donnell 

Mortensen 

Garcia 


studentQuery3: select range variable.Method 
ClaireOQContoso.com, 206-555-0298 
SvenMortQContoso.com, 206-555-1130 
CesarGar@Contoso.com, 206-555-0521 


studentQuery4: select range variable[index] 


First score = 75 
First score = 88 
First score = 97 


studentQuery5: select expression 


Adjusted first score = 82.5 
Adjusted first score = 96.8 
Adjusted first score = 106.7 


studentQuery6: select expression2 
Average = 72.25 
Average = 84.5 


Average - 88.25 


studentQuery7: select new anonymous type 
O'Donnell, Claire 

Mortensen, Sven 

Garcia, Cesar 


studentQuery8: select new named type 


ID - 112, Average - 72.25 
ID - 113, Average - 84.5 
ID = 114, Average = 88.25 


studentQuery9: select result of join clause 
ID = 114, Email = CesarGar@Contoso.com 





如 上 一 个 示例 中 的 studentQuery8 所 示 ， 您 有 时 可 能 希望 所 返回 序列 中 的 元 素 仅 包 
含 源 元 素 的 属性 子 集 。 通 过 使 返回 的 序列 尽 可 能 地 小 一 些 ， 可 以 降低 内 存 需求 ， 并 
提高 查询 的 执行 速度 。 通 过 在 select 子 句 中 创建 一 个 匿名 类 型 ， 并 且 借 助 于 对 象 初 
始 值 设 定 项 用 源 元 素 中 的 适当 属性 对 该 匿名 类 型 进行 初始 化 ， 可 以 达到 此 目的 。 有 
关 如 何 执行 此 操作 的 示例 ， 请 参见 对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) o 


备注 


编译 时 ，select 子 句 会 被 转换 为 对 Select<TSource, TResult> 标准 查询 运算 符 的 方 
法 调用 。 


请 参阅 

C# 参考 

查询 关键 字 (CH 参考 ) 

from FA (CH 参考 ) 

分 部 (AK) (C# BS) 

匿名 类 型 (C# 编程 指南 ) 

LINQ 查询 表达 式 (C# 编程 指南 ) 
Getting Started with LINQ in C# 


group £4) (C£ 2X) 


group 子 句 返回 一 个 IGroupingcTKey, TElement» 对 象 序列 ， 这 些 对 象 包含 规 个 
或 更 多 个 与 该 组 的 键 值 匹 配 的 项 。 例 如 ， 可 以 按照 每 个 字符 串 中 的 第 一 个 字母 对 字 
符 串 序列 进行 分 组 。 在 这 种 情况 下 ， 第 一 个 字母 是 键 且 具有 char 类 型 ， 并 且 存 储 
在 每 个 IGroupingcTKey, TElement» 对 象 的 Key 属性 中 。 编 译 器 可 推断 该 键 的 类 
型 。 


可 以 用 group 子 句 结束 查询 表达 式 ， 如 下 面 的 示例 所 示 : 


// Query variable is an IEnumerable<IGrouping<char, Student>> 
var studentQuery1 = 

from student in students 

group student by student.Last[0]; 


如 果 您 想 要 对 每 个 组 执行 附加 查询 操作 ， 则 可 以 使 用 into 上 下 文 关 键 字 指 定 一 个 临 
时 标识 符 。 使 用 into 时 ， 必 须 继续 编写 该 查询 ， 并 最 终 用 一 个 select 语句 或 另 一 
个 group 子 句 结束 该 查询 ， 如 下 面 的 代码 摘录 所 示 : 


// Group students by the first letter of their last name 
// Query variable is an IEnumerable<IGrouping<char, Student>> 
var studentQuery2 - 

from student in students 

group student by student.Last[0] into g 

orderby g.Key 

select g; 


本 主题 中 的 "示例 ”部 分 中 提供 了 使 用 含有 和 不 含 into 的 group 的 更 完整 示例 。 


枚 举 组 查询 的 结果 


由 于 group 查询 产生 的 IGrouping<TKey, TElement> 对 象 实质 上 是 列表 的 列表 ， 
因此 必须 使 用 灸 套 的 foreach 循环 来 访问 每 一 组 中 的 各 个 项 。 外 部 循环 用 于 循环 访 
问 组 键 ， 内 部 循环 用 于 循环 访问 组 本 身 中 的 每 个 项 。 组 可 能 具有 键 ， 但 没有 元 素 。 
以 下 是 执行 上 述 代码 示例 中 的 查询 的 foreach 循环 : 


// Iterate group items with a nested foreach. This IGrouping encap: 
// a sequence of Student objects, and a Key of type char. 
// For convenience, var can also be used in the foreach statement. 
foreach (IGrouping«char, Student» studentGroup in studentQuery2) 
{ 

Console.WriteLine(studentGroup.Key); 

// Explicit type for student could also be used here. 

foreach (var student in studentGroup) 


{ 
Console.WriteLine(" (0), {1}", student.Last, student.Fi! 





键 类 类 型 


组 键 可 以 是 任何 类 型 ， 如 字符 串 、 内 置 数值 类 型 、 用 户 定义 的 命名 类 型 或 匿名 类 
型 。 


按 字符 串 进 行 分 组 
上 述 代码 示例 使 用 的 是 char。 可 以 很 容易 地 改 为 指定 字符 串 键 ， 如 完整 的 姓氏 : 


// Same as previous example except we use the entire last name as : 
// Query variable is an IEnumerable<IGrouping<string, Student>> 
var studentQuery3 - 

from student in students 

group student by student.Last; 


E 
按 布 尔 进行 分 组 


下 面 的 示例 演示 使 用 布尔 值 作为 键 将 结果 划分 成 两 个 组 。 请 注意 ， 该 值 是 由 group 
子 句 中 的 子 表 达 式 产生 的 。 





class GroupSamplei 
{ 
// The element type of the data source. 
public class Student 
{ 
public string First { get; set; } 
public string Last { get; set; } 
public int ID { get; set; } 
public List<int> Scores; 


public static List<Student> GetStudents() 
{ 
// Use a collection initializer to create the data source. 
// in the list contains an inner sequence of scores. 
List<Student> students = new List<Student> 
{ 
new Student {First="Svetlana", Last="0melchenko", ID=11: 
new Student {First="Claire", Last="0'Donnell", ID-112, : 
new Student {First="Sven", Last="Mortensen", ID-113, Sc 
new Student {First="Cesar", Last="Garcia", ID=114, Score 
new Student {First="Debra", Last="Garcia", ID=115, Score 


}; 
return students; 


j 


static void Main() 

1 
// Obtain the data source. 
List<Student> students = GetStudents(); 


// Group by true or false. 
// Query variable is an IEnumerable«IGrouping«bool, Student 
var booleanGroupQuery - 

from student in students 

group student by student.Scores.Average() >= 80; //pas: 


// Execute the query and access items in each group 
foreach (var studentGroup in booleanGroupQuery) 


{ 


Console.WriteLine(studentGroup.Key == true ? "High ave) 
foreach (var student in studentGroup) 


{ 
} 


Console.WriteLine(" {0}, {1}:{2}", student -Last, 


} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Output: 
Low averages 
Omelchenko, Svetlana:77.5 
O'Donnell, Claire:72.25 
Garcia, Cesar:75.5 
High averages 
Mortensen, Sven:93.5 
Garcia, Debra:88.25 
RU 


«| n 








«| 








按 数 值 范 围 进行 分 组 


下 一 个 示例 使 用 表达 式 创建 表示 百分比 范围 的 数值 组 键 。 请 注意 ， 该 示例 使 用 let 
作为 方法 调用 结果 的 方便 存储 位 置 ， 从 而 无 需 在 group 子 句 中 调用 该 方法 两 次 。 另 
请 注意 ， 在 group 子 句 中 ， 为 了 避免 发 生 "“ 被 需 除 "异常 ， 代 码 进行 了 相应 检查 以 确 
保 学 生 的 平均 成 绩 不 为 震 。 有 关 如 何在 查询 表达 式 中 安全 使 用 方法 的 更 多 信息 ， 请 
参见 如 何 : 在 查询 表达 式 中 处 理 异 常 (CH 编程 指南 ) o 


class GroupSample2 


{ 


// The element type of the data source. 
public class Student 


{ 
public string First { get; set; } 
public string Last { get; set; } 
public int ID { get; set; } 
public List<int> Scores; 
} 
public static List<Student> GetStudents() 
{ 
// Use a collection initializer to create the data source. 
// in the list contains an inner sequence of scores. 
List<Student> students = new List<Student> 
{ 
new Student {First="Svetlana", Last="0melchenko", ID=11: 
new Student {First="Claire", Last="0'Donnell", ID=112, : 
new Student {First="Sven", Last="Mortensen", ID-113, Sc 
new Student {First="Cesar", Last="Garcia", ID=114, Score 
new Student {First="Debra", Last="Garcia", ID=115, Score 
J; 
return students; 
} 


// This method groups students into percentile ranges based on 
// grade average. The Average method returns a double, so to pi 
// number it is necessary to cast to int before dividing by 10` 
static void Main() 
{ 

// Obtain the data source. 

List<Student> students = GetStudents(); 


// Write the query. 
var studentQuery = 
from student in students 
let avg = (int)student.Scores.Average( ) 
group student by (avg == 0 ? 0 : avg / 10) intog 
orderby g.Key 


select g; 


// Execute the query. 
foreach (var studentGroup in studentQuery) 


{ 
int temp = studentGroup.Key * 10; 
Console.WriteLine("Students with an average between {0 
foreach (var student in studentGroup) 
{ 

Console.WriteLine(" {0}, {1}:{2}", student.Last, 

} 

} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 

} 


} 
/* Output: 
Students with an average between 70 and 80 
Omelchenko, Svetlana:77.5 
O'Donnell, Claire:72.25 
Garcia, Cesar:75.5 
Students with an average between 80 and 90 
Garcia, Debra:88.25 
Students with an average between 90 and 100 
Mortensen, Sven:93.5 





按 复合 键 进行 分 组 


当 您 想 要 按照 多 个 键 对 元 素 进 行 分 组 时 ， 可 使 用 复合 键 。 通 过 使 用 匿名 类 型 或 命名 
类 型 来 存储 键 元 素 ， 可 以 创建 复合 键 。 在 下 面 的 示例 中 ， 假 定 已 经 使 用 名 为 
surname 和 city 的 两 个 成 员 声 明了 类 Person。 group 子 句 使 得 为 每 组 具有 相同 姓 
氏 和 相同 城市 的 人 员 创 建 一 个 单独 的 组 。 


group person by new (name = person.surname, city = person.city); 


如 果 必 须 将 查询 变量 传递 给 其 他 方法 ， 请 使 用 命名 类 型 。 使 用 自动 实现 的 属性 作为 
键 来 创建 一 个 特殊 类 ， 然 后 重 写 Equals 和 GetHashCode 方法 。 还 可 以 使 用 结 

构 ; 在 此 情况 下 ， 并 不 绝对 需要 重 写 这 些 方法 。 有 关 更 多 信息 ， 请 参见 如 何 : 使 用 
自动 实现 的 属性 实现 轻 量 类 (CH 编程 指南 ) 和 How to: Query for Duplicate Files in 
a Directory Tree (LINQ)。 后 一 个 主题 包含 一 个 代码 示例 ， 该 示例 演示 如 何 将 复合 
键 与 命名 类 型 结合 使 用 。 


下 面 的 示例 演示 在 没有 向 组 应 用 附加 查询 逻辑 时 将 源 数据 排序 放 入 不 同 组 中 的 标 
模式 。 这 称 为 不 带 延 续 的 分 组 。 字 符 串 数组 中 的 元 素 按照 它们 的 第 一 个 字母 进行 分 
组 。 查 询 结 果 是 一 个 1Grouping<TKey, TElement> 类 型 ， 其 中 包含 一 个 char 类 型 


的 公共 Key 属性 以 及 一 个 包含 分 组 中 每 个 项 的 IEnumerable<T> 集合 。 


group 子 句 的 结果 是 序列 的 序列 。 因 此 ， 若 要 访问 所 返回 的 每 个 组 中 的 单个 元 素 ， 
请 在 循环 访问 组 键 的 循环 内 使 用 伐 套 的 foreach 循环 ， 如 下 面 的 示例 所 示 。 


class GroupExample1i 


( 


static void Main() 


// Create a data source. 
string[] words = { "blueberry", "chimpanzee", "abacus", "b: 


// Create the query. 

var wordGroups = 
from w in words 
group w by w[60]; 


// Execute the query. 
foreach (var wordGroup in wordGroups) 


{ 
Console.WriteLine("Words that start with the letter '{( 


foreach (var word in wordGroup) 


t 
} 


Console.WriteLine(word); 


j 


// Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 

Jj 


} 
/* Output: 
Words that start with the letter 'b': 
blueberry 
banana 
Words that start with the letter 'c': 
chimpanzee 
cheese 
Words that start with the letter 'a': 
abacus 
apple 
we 


LE 





此 示例 演示 在 创建 组 之 后 ， 如 何 使 用 通过 into 实现 的 延续 对 这 些 组 执行 附加 逮 辑 。 
有 关 更 多 信息 ， 请 参见 into (CH 参考 ) 。 下 面 的 示例 查询 每 个 组 以 仅 选择 那些 键 
值 为 元 音 的 元 素 。 


class GroupClauseExample2 
{ 
static void Main() 
{ 
// Create the data source. 
string[] words2 = { "blueberry", "chimpanzee", 


// Create the query. 
var wordGroups2 = 
from w in words2 
group w by w[0] into grps 
where (grps.Key == 'a' || grps.Key == 'e' 
|| grps.Key == 'o' || grps.Key == ' 
select grps; 


// Execute the query. 
foreach (var wordGroup in wordGroups2) 


{ 


"abacus", "I 


| grps.Key : 
|) 


| 
U 


Console.WriteLine("Groups that start with a vowel: {0}' 


foreach (var word in wordGroup) 


i 
} 


Console.WriteLine(" {0}", word); 


} 


// Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Output: 
Groups that start with a vowel: a 
abacus 
apple 
anteater 
Groups that start with a vowel: e 
elephant 
Groups that start with a vowel: u 
umbrella 





备注 


编译 时 ，group 子 句 被 转换 为 对 GroupBy<TSource，TKey> 方法 的 调用 。 


请 参阅 


MSDN C# 编程 指南 & 参考 手册 2015 


IGrouping<TKey, TElement> 
GroupBy<TSource, TKey> 
ThenBy<TSource, TKey> 
ThenByDescending<TSource, TKey> 

查询 关键 字 (C# 参考 ) 

LINQ 查询 表达 式 (CH 编程 指南 ) 

如 何 : 创建 戏 套 组 (CH 编程 指南 ) 

如 何 : 对 查询 结果 进行 分 组 (CH 编程 指南 ) 
如 何 : 对 分 组 操作 执行 子 查询 (CH 编程 指南 ) 


group 子 句 (CH 参考 ) 


938 


into (CX 参考 ) 


可 以 使 用 into 上 下 文 关键 字 创建 一 个 临时 标识 符 ， 以 便 将 group, join 或 select F 
句 的 结果 存储 到 新 的 标识 符 中 。 此 标识 符 本 身 可 以 是 附加 查询 命令 的 生成 器 。 在 
group 或 select 子 句 中 使 用 新 标识 符 的 用 法 有 时 称 为 “延续”。 


下 面 的 示例 演示 使 用 into 关键 字 来 启用 临时 标识 符 fruitGroup， 该 标识 符 具有 推断 
类 型 |IGrouping。 通 过 使 用 该 标识 符 ， 可 以 对 每 个 组 调用 Count<TSource> 方法 ， 
并 且 仅 选择 那些 包含 两 个 或 更 多 个 单词 的 组 。 


class IntoSample1 


{ 
static void Main() 
{ 
// Create a data source. 
string[] words = { "apples", "blueberries", "oranges", "bar 
// Create the query. 
var wordGroupsi = 
from w in words 
group w by w[0] into fruitGroup 
where fruitGroup.Count() »- 2 
select new { FirstLetter = fruitGroup.Key, Words = fru: 
// Execute the query. Note that we only iterate over the gl 
// not the items in each group 
foreach (var item in wordGroups1) 
{ 
Console.WriteLine(" {0} has {1} elements.", item.Firstl 
} 
// Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Output: 


a has 2 elements. 
b has 2 elements. 





仅 当 和 希 zu i 作 时 ， 才 需要 在 group SAHA into. AX 
更 多 信息 ， 请 参见 group FA (CK 参考 ) 。 


ARE join 子 句 中 使 用 into 的 示例 ， 请 参见 join 子 句 〈C# 参考 ) 。 
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请 参阅 
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LINQ 查询 表达 式 (CH 编程 指南 ) 
group FA (CH 参考 ) 


into (C# 参考 ) 


940 


orderby +4) (C# 2X) 


在 查询 表达 式 中 ，orderby 子 句 可 使 返回 的 序列 或 子 序列 (组) 按 升 序 或 降序 排 

序 。 可 以 指定 多 个 键 ， 以 便 执 行 一 个 或 多 个 次 要 排序 操作 。 排 序 是 由 针对 元 素 类 型 
的 默认 比较 器 执行 的 。 默 认 排 序 顺 序 为 升序 。 您 还 可 以 指定 自 定义 比较 器 。 但 是 ， 

只 能 通过 基于 方法 的 语法 使 用 它 。 有 关 更 多 信息 ， 请 参见 Sorting Data, 


在 下 面 的 示例 中 ， 第 一 个 查询 按 从 A 开始 的 字母 顺序 对 单词 进行 排序 ， 第 二 个 查询 
按 降 序 对 相同 的 单词 进行 排序 。 (ascending 关键 字 是 默认 排序 值 ， 可 以 省 略 。) 


class OrderbySamplei 


{ 
static void Main() 
{ 
// Create a delicious data source. 
string[] fruits = { "cherry", "apple", "blueberry" }; 
// Query for ascending sort. 
IEnumerable<string> sortAscendingQuery = 
from fruit in fruits 
orderby fruit //"ascending" is default 
select fruit; 
// Query for descending sort. 
IEnumerable<string> sortDescendingQuery = 
from w in fruits 
orderby w descending 
select w; 
// Execute the query. 
Console.WriteLine("Ascending:"); 
foreach (string s in sortAscendingQuery) 
{ 
Console.WriteLine(s); 
} 
// Execute the query. 
Console.WriteLine(Environment.NewLine + "Descending:"); 
foreach (string s in sortDescendingQuery) 
{ 
Console.WriteLine(s); 
} 
// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
/* Output: 
Ascending: 
apple 
blueberry 
cherry 
Descending: 
cherry 
blueberry 
apple 
E 


下 面 的 示例 对 学 生 的 姓氏 执行 主要 排序 ， 然 后 对 他 们 的 名 字 执 行 次 要 排序 。 


class OrderbySample2 


{ 


// The element type of the data source. 
public class Student 


( 


} 


public string First { get; set; } 
public string Last { get; set; } 
public int ID { get; set; } 


public static List<Student> GetStudents() 


{ 


} 


// Use a collection initializer to create the data source. 
// in the list contains an inner sequence of scores. 
List<Student> students = new List<Student> 
{ 
new Student {First="Svetlana", Last="0melchenko", ID=11: 
new Student {First="Claire", Last="0'Donnell", ID=112}, 
new Student {First="Sven", Last="Mortensen", ID=113}, 
new Student {First="Cesar", Last="Garcia", ID=114}, 
new Student {First="Debra", Last="Garcia", ID=115} 


P 


return students; 


static void Main(string[] args) 


{ 


// Create the data source. 
List<Student> students = GetStudents(); 


// Create the query. 

IEnumerable<Student> sortedStudents = 
from student in students 
orderby student.Last ascending, student.First ascending 
select student; 


// Execute the query. 

Console.WriteLine("sortedStudents:"); 

foreach (Student student in sortedStudents) 
Console.WriteLine(student.Last + " " + student.First); 


// Now create groups and sort the groups. The query first : 
// of all students so that they will be in alphabetical or 
// grouped. The second orderby sorts the group keys in alpl 
var sortedGroups - 

from student in students 

orderby student.Last, student.First 

group student by student.Last[0] into newGroup 

orderby newGroup.Key 

select newGroup; 


// Execute the query. 
Console.WriteLine(Environment.NewLine + "sortedGroups:"); 
foreach (var studentGroup in sortedGroups) 


{ 
Console.WriteLine(studentGroup.Key); 
foreach (var student in studentGroup) 
{ 
Console.WriteLine(" {0}, {1}", student.Last, stuc 
J 
} 


// Keep the console window open in debug mode 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 

} 

/* Output: 

sortedStudents: 

Garcia Cesar 

Garcia Debra 

Mortensen Sven 

O'Donnell Claire 

Omelchenko Svetlana 


sortedGroups: 

G 
Garcia, Cesar 
Garcia, Debra 


M 
Mortensen, Sven 
0 
O'Donnell, Claire 
Omelchenko, Svetlana 
à 





备注 


编译 时 ，orderby 子 句 被 转换 为 对 OrderBy<TSource, TKey> 方法 的 调用 。 
orderby 子 句 中 的 多 个 键 转换 为 ThenBy<TSource, TKey> 方法 调用 。 


请 参阅 
CH 参考 


查询 关键 字 (CH 参考 ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 
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join +o) (CH 2X) 


使 用 join 子 句 可 以 将 来 自 不 同 源 序列 并 且 在 对 象 模型 中 没有 直接 关系 的 元 素 相关 
联 。 唯 一 的 要 求 是 每 个 源 中 的 元 素 需 要 共享 某 个 可 以 进行 比较 以 判断 是 否 相 等 的 
值 。 例 如 ， 食 品 经 销 丙 可 能 具有 某 种 产品 的 供应 丙 列 表 以 及 买主 列表 。 例 如 ， 可 以 
使 用 join 子 句 创 建 该 产品 同一 指定 地 区 供应 两 和 买主 的 列表 。 


join 子 句 接受 两 个 源 序列 作为 输入 。 每 个 序列 中 的 元 素 都 必须 是 可 以 与 另 一 个 序列 
中 的 相应 属性 进行 比较 的 属性 ， 或 者 包含 一 个 这 样 的 属性 。 join 子 句 使 用 特殊 的 
equals 关键 字 比 较 指定 的 键 是 否 相 等 。 join 子 句 执行 的 所 有 联接 都 是 同等 联接 。 
join 子 句 的 输出 形式 取决 于 所 执行 的 联接 的 具体 类 型 。 以 下 是 三 种 最 常见 的 联接 类 
型 : 

e 内 部 联接 

e 分 组 联接 


。 左 外 部 联接 


内 部 联接 


下 面 的 示例 演示 一 个 简单 的 内 部 同等 联接 。 此 查询 产生 一 个 “产品 名 称 /类 别 ? 对 平面 
序列 。 同 一 类 别 字符 串 将 出 现在 多 个 元 素 中 。 如 果 categories 中 的 某 个 元 素 不 具有 
匹配 的 products， 则 该 类 别 不 会 出 现在 结果 中 。 


var innerJoinQuery = 
from category in categories 
join prod in products on category.ID equals prod.CategoryID 
select new ( ProductName - prod.Name, Category - category.Name 


B ss: 
有 关 更 多 信息 ， 请 参见 如 何 : 执行 内 部 联接 (CH 编程 指南 ) o 





Group Join 
含有 into 表达 式 的 join 子 句 称 为 分 组 联接 。 


var innerGroupJoinQuery = 
from category in categories 
join prod in products on category.ID equals prod.CategoryID int 
select new ( CategoryName = category.Name, Products = prodGrou[ 


‘ = 








分 组 联接 会 产生 一 个 分 层 的 结果 序列 ， 该 序列 料 左 侧 源 序 列 中 的 元 素 与 右 侧 源 序列 
中 的 一 个 或 多 个 匹配 元 素 相关 联 。 分 组 联接 没有 等 效 的 关系 术语 ; 它 本 质 上 是 一 个 
对 象 数组 序列 。 


如 果 在 右 侧 源 序列 中 找 不 到 与 左 侧 源 中 的 元 素 相 匹 配 的 元 素 ， 则 join 子 句 会 为 该 项 
产生 一 个 空 数组 。 因 此 ， 分 组 联接 基本 上 仍然 是 一 种 内 部 同等 联接 ， 区 别 只 在 于 分 
组 联接 将 结果 序列 组 织 为 多 个 组 。 


如 果 您 只 选择 分 组 联接 的 结果 ， 则 可 以 访问 各 个 项 ， 但 无 法 识别 结果 所 匹配 的 键 。 
因此 ， 通 常 更 为 有 用 的 做 法 是 选择 分 组 联接 的 结果 并 放 入 一 个 也 具有 该 键 名 的 新 类 
型 中 ， 如 上 一 个 示例 所 示 。 


当然 ， 还 可 以 将 分 组 联接 的 结果 用 作 其 他 子 查询 的 生成 器 : 


var innerGroupJoinQuery2 = 
from category in categories 
join prod in products on category.ID equals prod.CategoryID int 
from prod2 in prodGroup 
where prod2.UnitPrice » 2.50M 
select prod2; 





有 关 更 多 信息 ， 请 参见 如 何 : 执行 分 组 联接 (CH 编程 指南 ) o 


左 外 部 联接 


在 左 外 部 联接 中 ， 将 返回 左 侧 源 序列 中 的 所 有 元 素 ， 即 使 它们 在 右 侧 序列 中 没有 匹 
配 的 元 素 也 是 如 此 。 若 要 在 LINQ 中 执行 左 外 部 联接 ， 请 将 DefaultlfEmpty 方法 
与 分 组 联接 结合 起 来 ， 以 指定 要 在 某 个 左 侧 元 素 不 具有 匹配 元 素 时 产生 的 默认 右 例 
元 素 。 可 以 使 用 null 作为 任何 引用 类 型 的 默认 值 ， 也 可 以 指定 用 户 定义 的 默认 类 
型 。 下 面 的 示例 演示 了 用 户 定 义 的 默认 类 型 : 


var leftOuterJoinQuery = 
from category in categories 
join prod in products on category.ID equals prod.CategoryID int 
from item in prodGroup.DefaultlIfEmpty(new Product { Name = Str: 
select new ( CatName = category.Name, ProdName = item.Name }; 


| = ae 
有 关 更 多 信息 ， 请 参见 如 何 : 执行 左 外 部 联接 (C# 编程 指南 ) o 





equals 运算 符 


join 子 句 执行 同等 联接 。 换 名 话说， 只 能 基于 两 个 键 之 间 的 相等 关系 进行 匹配 。 其 
他 类 型 的 比较 (IDO, "greater than” 或 “not equals") 不 受 支持 。 为 了 表明 所 有 联接 
都 是 同等 联接 ，join 子 句 使 用 equals 关键 字 而 不 是 == 运算 符 。 equals 关键 字 只 


能 用 在 join jh, FACS == 运算 符 之 间 存 在 一 个 重要 区 别 。 对 于 equals, 
左 键 使 用 外 部 源 序列 ， 而 右键 使 用 内 部 源 序列 。 外 部 源 仅 在 equals 的 左 侧 位 于 范 
内 ， 而 内 部 源 序 列 仅 在 其 右 侧 位 于 范围 内 。 


非 同 等 联接 


通过 使 用 多 个 from 子 句 将 新 序列 单独 引入 到 查询 中 ， 可 以 执行 非 同等 联接 、 交 叉 
联接 和 其 他 自 定义 联接 操作 。 有 关 更 多 信息 ， 请 人 参见 如 何 : ATA RRR 
(C? 编程 指南 ) o 


对 象 集 合 联接 与 关系 表 


在 LINQ 查询 表达 式 中 ， 联 接 操作 是 在 对 象 集合 上 执行 的 。 不 能 使 用 与 两 个 关系 表 
完全 相同 的 方式 “联接 "对 象 集合 。 在 LINQ 中 ， 仅 当 两 个 源 序列 没有 通过 任何 关系 
相互 联系 时 ， 才 需要 使 用 显 式 join 子 句 。 使 用 LINQ to SQL 时 ， 外 键 表 在 对 象 模 
型 中 表示 为 主 表 的 属性 。 例 如 ， 在 Northwind 数据 库 中 ，Customer 表 与 Orders X 
之 间 具 有 外 键 关 系 。 在 将 这 两 个 表 上 映射 到 对 象 模型 时 ，Customer 类 具有 一 个 
Orders 属性 ， 该 属性 包含 与 该 Customer 相关 联 的 Orders 的 集合 。 实 际 上 ， 已 经 
为 您 执行 了 联接 。 


AAT LINQ to SQL 的 上 下 文中 跨 相 关 表 执行 查询 的 更 多 信息 ， 请 参见 如 何 : 映射 
数据 库 关 系 。 


复合 键 


使 用 复合 键 可 以 测试 多 个 值 是 否 相等 。 有 关 更 多 信息 ， 请 参见 如 何 : 使 用 复合 键 进 
行 联接 (CH 编程 指南 ) 。 还 可 以 在 group 子 句 中 使 用 组 合 键 。 


下 面 的 示例 比较 了 使 用 相同 的 匹配 键 对 相同 数据 源 执行 内 部 联接 、 分 组 联接 和 左 外 
部 联接 的 结果 。 这 些 示例 中 添加 了 一 些 额 外 的 代码 ， 以 便 在 控制 台 显 示 中 阐明 结 
果 。 


class JoinDemonstration 


( 


#region Data 


class Product 


{ 
public string Name { get; set; } 
public int CategoryID { get; set; } 
} 
class Category 
{ 


public string Name { get; set; } 
public int ID { get; set; } 


{ 


} 


// Specify the first data source. 
List<Category> categories = new List<Category>() 


( 


new Category(){Name="Beverages", ID=001}, 
new Category(){ Name="Condiments", ID=002}, 
new Category(){ Name="Vegetables", ID=003}, 
new Category() { Name="Grains", ID=004}, 
new Category() { Name="Fruit", ID=005} 


H 


// Specify the second data source. 
List«Product» products = new List<Product>() 


new Product{Name="Cola",  CategoryID-001), 
new Product{Name="Tea",  CategoryID-001), 
new Product{Name="Mustard", CategoryID-002], 
new Product{Name="Pickles", CategoryID-002], 
new Product{Name="Carrots", CategoryID-003], 
new Product{Name="Bok Choy", CategoryID=003}, 
new Product{Name="Peaches", CategoryID=005}, 
new Product{Name="Melons", CategoryID-005], 
J; 
#endregion 


static void Main(string[] args) 


{ 


JoinDemonstration app = new JoinDemonstration(); 


app.InnerJoin(); 
app.GroupJoin(); 
app.GroupInnerJoin(); 
app.GroupJoin3(); 
app.LeftOuterJoin(); 
app.LeftOuterJoin2(); 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


j 


void InnerJoin() 


( 


// Create the query that selects 
// a property from each element. 
var innerJoinQuery - 


from category in categories 
join prod in products on category.ID equals prod.Catego! 
select new { Category = category.ID, Product = prod.Name 


Console.WriteLine("InnerJoin:"); 
// Execute the query. Access results 


j 


// with a simple foreach statement. 
foreach (var item in innerJoinQuery) 


{ 
} 


Console.WriteLine("InnerJoin: {0} items in 1 group.", inne! 
Console.WriteLine(System.Environment.NewLine); 


Console.WriteLine("{0, -10}{1}", item.Product, item.Cate 


void GroupJoin() 


( 


} 


// This is a demonstration query to show the output 

// of a "raw" group join. A more typical group join 

// is shown in the GroupInnerJoin method. 

var groupJoinQuery = 
from category in categories 
join prod in products on category.ID equals prod.Catego! 
select prodGroup; 


// Store the count of total items (for demonstration only) 
int totalItems = 0; 


Console.WriteLine("Simple GroupJoin:"); 


// A nested foreach statement is required to access group : 
foreach (var prodGrouping in groupJoinQuery) 


{ 
Console.WriteLine("Group:"); 
foreach (var item in prodGrouping) 
{ 
totalItems++; 
Console.WriteLine(" {0, -10}{1}", item.Name, item 
} 
} 


Console.WriteLine("Unshaped GroupJoin: {0} items in {1} unr 
Console.WriteLine(System.Environment.NewLine); 


void GroupInnerJoin() 


( 


var groupJoinQuery2 - 

from category in categories 

orderby category.ID 

join prod in products on category.ID equals prod.Categt 

select new 

{ 
Category 
Products 


category.Name, 

from prod2 in prodGroup 
orderby prod2.Name 
select prod2 


H 


} 


//Console.WriteLine("GroupInnerJoin:"); 
int totalItems = 0; 


Console.WriteLine("GroupInnerJoin:"); 
foreach (var productGroup in groupJoinQuery2) 
{ 
Console.WriteLine(productGroup.Category); 
foreach (var prodItem in productGroup.Products) 
{ 
totalItems++; 
Console.WriteLine("  (0,-10) {1}", prodItem.Name, [ 
j 
j 
Console.WriteLine("GroupInnerJoin: {0} items in {1} named ( 
Console.WriteLine(System.Environment.NewLine); 


void GroupJoin3() 


{ 


} 


var groupJoinQuery3 = 
from category in categories 
join product in products on category.ID equals product 
from prod in prodGroup 
orderby prod.CategoryID 
select new { Category = prod.CategoryID, ProductName = 


//Console.WriteLine("GroupInnerJoin:"); 
int totalItems = 0; 


Console.WriteLine("GroupJoin3:"); 
foreach (var item in groupJoinQuery3) 
{ 
totalItems++; 
Console.WriteLine(" {O}:{1}", item.ProductName, item 


} 


Console.WriteLine("GroupJoin3: {0} items in 1 group", tota. 
Console.WriteLine(System.Environment.NewLine); 


void LeftOuterJoin() 


£ 


// Create the query. 

var leftOuterQuery = 
from category in categories 
join prod in products on category.ID equals prod.Catego! 
select prodGroup.DefaultIfEmpty(new Product() { Name = ' 


// Store the count of total items (for demonstration only) 
int totalItems = 0; 


Console.WriteLine("Left Outer Join:"); 


B 
/*Ou 


Inne 
Cola 
Tea 

Must 
Pick 
Carr 
Bok 

Peac 
Melo 
Inne 


Unsh 


// A nested foreach statement is required to access group 
foreach (var prodGrouping in leftOuterQuery) 


t 
Console.WriteLine("Group:", prodGrouping.Count()); 
foreach (var item in prodGrouping) 
totalItems++; 
Console.WriteLine(" {0,-10}{1}", item.Name, item.( 
j 
j 


Console.WriteLine("LeftOuterJoin: {0} items in {1} groups", 
Console.WriteLine(System.Environment.NewLine); 


} 


void LeftOuterJoin2() 
{ 
// Create the query. 
var leftOuterQuery2 = 
from category in categories 
join prod in products on category.ID equals prod.Catego! 
from item in prodGroup.DefaultlIfEmpty() 
select new ( Name - item -- null ? "Nothing!" : item.Nar 


Console.WriteLine("LeftOuterJoin2: {0} items in 1 group", 
// Store the count of total items 
int totalItems = 0; 


Console.WriteLine("Left Outer Join 2:"); 


// Groups have been flattened. 
foreach (var item in leftOuterQuery2) 
{ 
totalItems++; 
Console.WriteLine("{0, -10}{1}", item.Name, item.Categoi 
} 


Console.WriteLine("LeftOuterJoin2: {0} items in 1 group", 1 


j 
tput: 


rJoin: 


ard 
les 
ots 
Choy 
hes 
ns 
rJoin: 8 items in 1 group. 
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aped GroupJoin: 


Group: 


Cola at 
Tea 1 
Group: 
Mustard 2 
Pickles 2 
Group: 
Carrots 3 
Bok Choy 3 
Group: 
Group: 
Peaches 5 
Melons 5 


Unshaped GroupJoin: 8 items in 5 unnamed groups 


GroupInnerJoin: 
Beverages 
Cola 1 
Tea 1 
Condiments 
Mustard 2 
Pickles 2 
Vegetables 
Bok Choy 3 
Carrots 3 
Grains 
Fruit 
Melons 5 
Peaches 5 


GroupInnerJoin: 8 items in 5 named groups 


GroupJoin3: 
Cola:1 
Tea:1 
Mustard:2 
Pickles:2 
Carrots:3 
Bok Choy:3 
Peaches:5 
Melons:5 
GroupJoin3: 8 items in 1 group 


Left Outer Join: 


Group: 
Cola 1 
Tea 1 
Group: 
Mustard 2 
Pickles 2 
Group: 
Carrots 3 
Bok Choy 3 


Group: 


Nothing! 4 


Group: 
Peaches 5 
Melons 5 


LeftOuterJoin: 9 items in 5 groups 


LeftOuterJoin2: 9 items in 1 group 
Left Outer Join 2: 

Cola 

Tea 
Mustard 
Pickles 
Carrots 
Bok Choy 
Nothing! 
Peaches 
Melons 
LeftOuterJoin2: 9 items in 1 group 
Press any key to exit. 

ur 


i ëR 
各 注 


后 面 未 跟 into 的 join 子 句 被 转换 为 Join<TOuter, TInner, TKey, TResult> 方法 调 
用 ; 后 面 跟 有 into 的 join 子 句 被 转换 为 GroupJoin<TOuter, TInner, TKey, 
TResult> 方法 调用 。 
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请 参阅 

查询 关键 字 (CH 参考 ) 

LINQ 查询 表达 式 (Cif 编程 指南 ) 

Join Operations 

group 子 句 (CH 参考 ) 

如 何 : 执行 左 外 部 联接 (CH 编程 指南 ) 
如 何 : 执行 内 部 联接 (CH 编程 指南 ) 

如 何 : 执行 分 组 联接 (CH 编程 指南 ) 

如 何 : 对 Join 子 句 的 结果 进行 排序 (CH 编程 指南 ) 
如 何 : 使 用 复合 键 进行 联接 (CH 编程 指南 ) 
如 何 : 安装 示例 数据 库 


. — 人 一 f Za +7 \ 
join FA (CH 2) 


let FA (CH 参考 ) 


在 查询 表达 式 中 ， 和 存储 子 表达 式 的 结果 有 时 很 有 用 ， 这 样 可 以 在 随后 的 子 句 中 使 
用 。 可 以 使 用 let 关键 字 完成 这 一 工作 ， 该 关键 字 可 以 创建 一 个 新 的 范围 变量 ， 并 
且 用 您 提供 的 表达 式 的 结果 初始 化 该 变量 。 一 旦 用 值 初始 化 了 该 范围 变量 ， 它 就 不 
能 用 于 存储 其 他 值 。 但 如 果 该 范围 变量 存储 的 是 可 查询 的 类 型 ， 则 可 以 对 其 进行 查 
询 。 

在 下 面 的 示例 中 ， 以 两 种 方式 使 用 了 let : 

1. 创建 一 个 可 以 查询 自身 的 可 枚 举 类 型 。 


2. 使 查询 只 能 对 范围 变量 word 调用 一 次 ToLower。 如 果 不 使 用 let， 则 必须 在 
where 子 句 的 每 个 谓词 中 调用 ToLower。 


class LetSamplei 
{ 


static void Main() 


1 


string[] strings - 


"A penny saved is a penny earned.", 
"The early bird catches the worm.", 
"The pen is mightier than the sword." 


P 


// Split the sentence into an array of words 
// and select those whose first letter is a vowel. 
var earlyBirdQuery = 
from sentence in strings 
let words = sentence.Split(' ') 
from word in words 
let w = word.ToLower() 
where w[0] == 'a' || w[0] == 'e' 
|| w[0] == 'i' || w[0] == 'o' 
|| w[0] == 'u' 
select word; 


// Execute the query. 
foreach (var v in earlyBirdQuery) 


{ 
} 


// Keep the console window open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 


Console.WriteLine("N"(0)N" starts with a vowel", v); 


} 

} 

/* Output: 
"A" starts with a vowel 
"is" starts with a vowel 
"a" starts with a vowel 
"earned." starts with a vowel 
"early" starts with a vowel 


is" starts with a vowel 


查询 关键 字 (CH 参考 ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


Getting Started with LINQ in C£ 
如 何 : 在 查询 表达 式 中 义理 异常 (CH 编程 指南 ) 


let F (CH 参考 ) 957 


ascending (C# 2) 

ascending 上 下 文 关 键 字 用 在 查询 表达 式 的 orderby 子 句 中 ， 用 于 指定 从 最 小 到 最 
大 的 排序 顺序 。 因 为 ascending 是 默认 排序 顺序 ， 所 以 您 无 须 指 定 它 。 

下 面 的 示例 演示 ascending 在 orderby 子 句 中 的 用 法 。 


IEnumerable<string> sortAscendingQuery = 
from vegetable in vegetables 
orderby vegetable ascending 
select vegetable; 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 
descending (C£ 参考 ) 


descending (C# 2) 

descending 上 下 文 关 键 字 用 在 查询 表达 式 的 orderby 子 句 中 ， 用 于 指定 从 最 大 到 
最 小 的 排序 顺序 。 

下 面 的 示例 演示 descending 在 orderby 子 句 中 的 用 法 。 


IEnumerable«string» sortDescendingQuery = 
from vegetable in vegetables 
orderby vegetable descending 
select vegetable; 


请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 
ascending (C£ 参考 ) 


on (C4 2) 


on 上 下 文 关 键 字 在 查询 表达 式 的 join 子 句 中 用 于 指定 联接 条 件 。 
下 面 的 示例 演示 on 在 join 子 句 中 的 用 法 。 
var innerJoinQuery = 
from category in categories 


join prod in products on category.ID equals prod.CategoryID 
select new ( ProductName - prod.Name, Category - category.Name 


图 | 





请 参阅 


LINQ 查询 表达 式 (C# 编程 指南 ) 


equals (C# 2) 


equals 上 下 文 关 键 字 用 在 查询 表达 式 的 join 子 句 中 ， 用 于 比较 两 个 序列 的 元 素 。 
有 关 更 多 信息 ， 请 参见 join FA (C# 参考 ) 。 


下 面 的 示例 演示 equals 关键 字 在 join 子 句 中 的 用 法 。 


var innerJoinQuery = 
from category in categories 
join prod in products on category.ID equals prod.CategoryID 
select new ( ProductName - prod.Name, Category - category.Name 





= 
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询 表 达 式 (CH 编程 指南 ) 


by (C# 参考 ) 


by 上 下 文 关 键 字 用 在 查询 表达 式 的 group 子 句 中 ， 用 于 指定 应 该 如 何 对 返回 的 项 
进行 分 组 。 有 关 更 多 信息 ， 请 参见 group FA (CH 参考 ) 。 

下 面 的 示例 演示 如 何在 group 子 句 中 使 用 by 上 下 文 关 键 字 ， 以 指定 按照 每 个 学 生 
姓氏 的 第 一 个 字母 对 学 生 进行 分 组 。 


var query = from student in students 
group student by student.LastName[0]; 


LINQ 查询 表达 式 (CH 编程 指南 ) 


in (C# 参考 ) 


in 上 下 文 关 键 字 可 在 下 面 三 种 上 下 文中 使 用 : 
e foreach 语句 
e 查询 表达 式 中 的 join F 
e 泛 型 接口 和 委托 中 的 泛 型 类 型 参数 。 


请 参阅 


C# 参考 


# 运算 符 


CH 提供 了 许多 运算 符 ， 这 些 运算 符 是 指定 要 在 表达 式 中 执行 哪些 操作 (RAP. 3 
Sl. WABASS) 的 符号 。 在 应 用 于 用 户 定义 类 型 之 前 ， 你 可 以 对 许多 运算 符 进 
行 重 载 以 更 改 其 含义 。 

针对 整 型 类 型 的 运算 (如 ==、!=、<、>、&、|) 通常 可 用 于 枚 举 (enum) 类 型 。 


以 下 章节 按 最 高 优先 级 到 最 低 优先 级 的 顺序 列 示 CH 运算 符 。 各 章节 内 运算 符 的 优 
先 级 相同 。 


主要 运算 符 

以 下 是 具有 最 高 优先 级 的 运算 符 。 请 注意 ， 你 可 以 单 击 运算 符 转 到 包含 示例 的 详细 
页 面 。 

x.y 一 成 员 访 问 。 

x?.y 一 null 条 件 成 员 访 问 。 如 果 左 边 操 作 数 为 null， 则 返回 null, 

f(x) = BGA FA. 

a[x] — 聚合 对 象 索引 。 

a?[x] 一 null 条 件 索 引 。 如 果 左 边 操 作 数 为 null， 则 返回 null, 


x++ 一 后 级 递增 。 先 返回 x 值 ， 然 后 用 加 1 (通常 加 整数 1) 后 的 x 值 更 新 存储 位 
iB. 


x-- 一 后 级 递减 。 先 返回 x 值 ， 然 后 用 减 1 (通常 减 整数 1) 后 的 x 值 更 新 存储 位 
iB. 


New 一 类 型 实例 化 

Typeof 一 返回 表示 操作 数 的 System.Type 对 象 。 

Checked 一 对 整数 运算 启用 浴 出 检查 。 

Unchecked 一 对 整数 运算 茶 用 浴 出 检查 。 这 是 默认 的 编译 器 行为 。 


default(T) 一 返回 类 型 T 的 默认 初始 化 值 ，T 为 引用 类 型 时 返回 null, T 为 数值 类 
型 时 返回 需 ，T 为 结构 类 型 时 返回 填充 为 老 /null 的 成 员 。 


Delegate 一 声明 并 返回 一 个 委托 实例 。 
Sizeof 一 返回 类 型 操作 数 的 大 小 〈 以 字 节 为 单位 ) 。 
-> 一 取消 指针 引用 与 成 员 访 问 相 结合 。 


一 元 运算 符 

这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 

+x 一 RE] x 值 。 

-X 一 数值 求 反 。 

Ix 一 逻辑 求 反 。 

~x 一 按 位 求 补 。 


++X 一 前 缀 递增 。 先 用 加 1 (通常 加 整数 1) 后 的 x 值 更 新 存储 位 置 ， 然 后 返回 x 
值 。 


--X 一 BUR. FA 1 〈 通 常 减 整数 1) 后 的 x 值 更 新 存储 位 置 ， 然 后 返回 x 
值 。 


(Tx 一 类 型 转换 。 
Await 一 4 Task. 
&x 一 地 址 。 

*x 一 取消 引用 。 


乘法 运算 符 

这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 

x* y 一 乘法 。 


T 除法 。 如 果 操 作 数 均 为 整数 ， 则 结果 为 整数 ， 舍 去 小 数 (例如 ，-7 /2 is 
-3) 。 


y 一 取 模 。 如 果 操 作 数 均 为 整数 ， 则 返回 x 除 以 y 后 的 余数 。 如 果 q=x/y 且 


x%y, 则 Xx=q*y+r。 


加 法 运算 符 


这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 
X 十 y 一 加 法 。 


x-y m 减法 。 


移 位 运算 符 

这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 

x<<y 一 向 左 移 位 ， 右 边 移出 的 空位 补 需 。 


x >> y 一 向 右 移 位 。 如 果 左 操作 数 是 int 或 long， 则 左 位 数 补 符号 位 。 如 果 左 操 
作 数 是 uint 或 ulong， 则 左 位 数 补 需 。 


关系 和 类 类 型 ae i] | 试 运 云 算 符 

这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 

x<y 一 小 于 (如果 xx 小 于 y， 则 为 true) 。 

x»y 一 大 于 (如果 x 大 于 y， 则 为 true) 。 

x <= y 一 小 于 等 于 。 

x >= y 一 大 于 等 于 。 


ls 一 类 型 兼容 性 。 如 果 求 值 后 的 左 操作 数 可 以 转换 为 右 操作 数 中 指定 的 类 型 (静态 
类 型 ) ， 则 返回 true, 


As 一 类 型 转换 。 返 回 左 操作 数 并 转换 为 右 操作 数 中 指定 的 类 型 (静态 类 型 ) ， 但 
as 返回 null， 其 中 (T)x 会 引发 异常 。 


相等 运算 符 
这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运算 符 转 
到 包含 示例 的 详细 页 面 。 


x == y 一 相等 。 默 认 情 况 下 ， 对 于 string 以 外 的 引用 类 型 ， 此 运算 符 返 回 引用 相 
等 (标识 测试 ) 。 但 是 ， 类 型 可 以 重 载 ==， 因 此 ， 如 果 你 想 测试 标识 ， 最 好 对 
object 使 用 ReferenceEquals 方法 。 


xl= y 一 不 相等 。 请 参阅 有 关 == 的 注释 。 如 果 某 个 类 型 重 载 ==， 则 它 必须 重 载 


Iz, 


逻辑 AND 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


x&y — 逻辑 或 位 AND。 与 整数 类 型 一 起 使 用 ， 并 且 通 常人 允许 enum 类 型 。 


逻辑 XOR 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


xy 一 逻辑 或 位 XOR。 通 常 可 以 将 此 运算 符 与 整数 类 型 和 enum 类 型 一 起 使 用 。 
逻辑 OR 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


Xx|y 一 逻辑 或 位 OR。 与 整数 类 型 一 起 使 用 ， 并 且 通 常人 允许 enum 类 型 。 


条 件 AND 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


x && y 一 逻辑 AND。 如 果 第 一 个 操作 数 为 false， 则 CH 不 对 第 二 个 操作 数 求 值 。 


条 件 OR 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


x||y — 逻辑 OR。 如 果 第 一 个 操作 数 为 true， 则 CH 不 对 第 二 个 操作 数 求 值 。 


Null 合并 运算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


x??y 一 如 果 不 为 null， 则 返回 x ; 否则 返回 y。 


条 件 运 算 符 


此 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 该 运算 符 转 
到 包含 示例 的 详细 页 面 。 


t?x:y — 如 果 测 试 t 为 true， 则 求 值 并 返回 x ; 否则 ， 求 值 并 返回 y. 


赋值 和 Lambda 运算 符 


这 些 运算 符 的 优先 级 比 下 一 章节 高 ， 比 上 一 章节 低 。 请 注意 ， 你 可 以 单 击 运 算 符 转 
到 包含 示例 的 详细 页 面 。 


X-y-- 赋值 。 


x+=y 一 递增 。x 值 加 y 值 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 如 果 x 指定 event, 
n) y 必须 是 CH 作为 事件 处 理 程序 添加 的 相应 画 数 。 


x--y — 递减 。 X 和 值 减 y 值 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 如 果 x 指定 event, 
则 y 必须 是 CH 作为 事件 处 理 程序 删除 的 相应 函数 


Xx “= y 一 乘法 赋值 。 x 值 乘 以 y 值 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 

x/=y 一 除法 赋值 。 Xx 值 除 以 y 值 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 

Xx %= y 一 取 模 赋值 。 x 值 除 以 y 值 ， 余 数 存储 在 x 中 ， 并 返回 新 值 。 

x&-y 一 AND Wio y A x 值 相 与 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 
x|=y 一 OR 赋值 。y 值 和 x 值 相 或 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 

x^-y 一 XOR 赋值 。y 值 和 x 值 相 异 或 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 
x««- y 一 Ze. Ex 值 向 左 移动 y 位 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 
X >>= y 一 右 移 赋值 。 将 x 值 向 右 移 动 y 位 ， 结 果 存 储 在 x 中 ， 并 返回 新 值 。 


=> 一 lambda 声明 。 


SUR IA 


算术 运算 符 (+、-、*、/) 产生 的 结果 可 能 会 超出 所 涉 数值 类 型 的 可 能 值 的 范围 。 
详细 信息 应 参考 特定 运算 符 的 相关 章节 ， 而 一 般 情 况 下 : 


e 整数 算术 浴 出 或 者 引发 OverflowException， 或 者 放弃 结果 的 最 高 有 效 位 。 整 
数 被 需 除 总 是 引发 DivideByZeroException。 


e 浮 点 算术 渝 出 或 被 堆 除 从 不 引发 异常 ， 因 为 浮 点 类 型 基于 IEEE 754， 因 此 可 
以 表示 无 穷 大 和 NaN ( 非 数 值 ) 。 


小 数 算术 渝 出 总 是 引发 OverflowException。 小 数 被 去 除 总 是 引发 
DivideByZeroException, 


当 发 生 整 数 浴 出 时 ， 产 生 的 结果 取决 于 执行 上 下 文 ， 该 上 下 文 可 为 checked 或 
unchecked, f£ checked 上 下 文中 引发 OverflowException。 在 unchecked EFX 
中 ， 放 弃 结 果 的 最 高 有 效 位 并 继续 执行 。 因 此 ，C# 让 你 有 机 会 选择 处 理 或 忽略 洽 
Ej. 


除 算术 运算 符 以 外 ， 整 型 类 型 之 间 的 转换 也 会 导致 浴 出 〈 例 如 ， 将 long 转换 为 
int) 并 受 checked 或 unchecked 执行 的 限制 。 但 是 ， 位 运算 符 和 移 位 运算 符 永 远 
不 会 导致 浴 出 。 
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i BN 〈C# 参考 ) 

方 括号 (0) 用 于 数组 、 索 引 器 和 特性 ， 也 可 用 于 指针 。 
备注 

数组 类 型 是 一 种 后 跟 [] 的 类 型 : 


int[] fib; // fib is of type int[], “array of int". 
fib = new int[100]; // Create a 100-element int array. 


若 要 访问 数组 的 一 个 元 素 ， 则 用 方 括号 括 起 所 需 元 素 的 索引 : 


fib[0] = fib[1] = 1; 
for (int i = 2; i < 100; ++i) fib[i] = fib[i - 1] + fib[i - 2]; 


如 果 数 组 索引 超出 范围 ， 则 会 引发 异常 。 


不 能 重 载 数组 索引 运算 符 ; 但 类 型 可 以 定义 采用 一 个 或 多 个 参数 的 索引 器 和 属性 。 
索引 器 参数 括 在 方 括号 中 ， 这 一 点 与 数组 索引 类 似 ; 但 可 以 将 索引 器 参数 声明 为 任 
何 类 型 ， 这 一 点 与 数组 索引 不 同 ， 后 者 必须 为 整形 。 


例如 ，.NET Framework 定义 Hashtable 类 型 ， 该 类 型 将 键 和 任意 类 型 的 值 关 联 在 


o 


System.Collections.Hashtable h - new System.Collections.Hashtable(: 
h["a"] = 123; // Note: using a string as the index. 


BEE 
方 括号 还 用 于 指定 特性 (C# Al Visual Basic) 





// using System.Diagnostics; 
[Conditional("DEBUG")] 
void TraceMethod() {} 


可 以 使 用 方 括号 来 指定 指针 索引 : 


unsafe void M() 


int[] nums = {0,1,2,3,4,5}; 
fixed ( int* p - nums ) 


p[0] = p[1] = 1; 
for( int i=2; i<100; ++i ) p[i] = p[i-1] + p[i-2]; 


不 执行 边界 检查 。 


CH EA 
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unsafe (C£ 参考 ) 
fixed 语句 (CH 参考 ) 


() 运算 符 (CR 参考 ) 


除了 用 于 指定 表达 式 中 运算 符 的 顺序 外 ， 圆 揪 号 还 用 于 执行 以 下 任务 : 
1. 指定 强制 转换 或 类 型 转换 。 


double x = 1234.7; 
int a; 
a = (int)x; // Cast double to int 


2. 调用 方法 或 委托 。 


TestMethod(); 


各 注 

强制 转换 显 式 调用 从 一 种 类 型 到 另 一 种 类 型 的 转换 运算 符 ; 如 果 未 定义 这 样 的 转换 
运算 符 ， 则 强制 转换 将 失败 。 若 要 定义 转换 运算 符 ， 请 参见 explicit 和 implicit. 
不 能 重 载 () 运算 符 。 

有 关 更 多 信息 ， 请 参见 强制 转换 和 类 型 转换 (CH 编程 指南 ) o 

强制 转换 表达 式 可 能 会 使 语法 发 生 歧 义 。 


例如 ， 表 达 式 (x)-y 既 可 以 解释 为 强制 转换 表达 式 ( 将 -y 强 制 转换 为 类 型 x ) ， 也 
可 以 解释 为 带 括号 的 相 加 表达 式 (计算 x-y 的 值 ) 。 


有 关 方 法 调用 的 详细 信息 ， 请 参阅 方法 (CH 编程 指南 ) 。 

CH 语言 规 泄 

有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 C# 语法 和 用 法 的 权威 资料 。 
请 参阅 

CH 参考 
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.运算 符 (CHESZ) 


mus SA C) 用 于 成 员 访 问 。 点 运算 符 指定 类 型 或 命名 空间 的 成 员 。 例 如 ， 点 运算 
符 用 于 访问 .NET Framework 类 库 中 的 特定 方法 : 


// The class Console in namespace System: 
System.Console.WriteLine("hello"); 


例如 ， 请 考虑 以 下 类 : 


class Simple 


public int a; 
public void b() 


{ 
} 


Simple s = new Simple(); 


变量 s 有 两 个 成 员 a 和 b ; 若 要 访问 这 两 个 成 员 ， 请 使 用 点 运算 符 : 


S.a = 6; // assign to field a; 
Sep je // invoke member function b; 


点 还 用 于 构造 限定 名 ， 即 指定 其 所 属 的 命名 空间 或 接口 的 名 称 。 


// The class Console in namespace System: 
System.Console.WriteLine("hello"); 


using 指令 使 某 些 名 称 限 定 可 选 : 


namespace ExampleNS 


{ 
using System; 
class C 
void M() 
{ 
System.Console.WriteLine("hello"); 
Console.WriteLine("hello"); // Same as previous line 
} 
} 
} 


4 O 
但 是 当 某 一 标识 符 不 确定 时 ， 必 须 限定 它 : 


namespace Example2 


1 
class Console 
{ 
public static void WriteLine(string s){} 
J 
} 
namespace Example1 
t 
using System; 
using Example2; 
class C 
void M() 
// Console.WriteLine("hello"); // Compiler error. Amt 
System.Console.WriteLine("hello"); //OK 
Example2.Console.WriteLine("hello"); //OK 
} 
} 
} 
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.运算 符 (CR S) 975 


:: 运算 符 (CH BS) 
命名 空间 别名 限定 符 (::) 用 于 查找 标识 符 。 它 通常 放置 在 两 个 标识 符 之 间 ， 例 如 : 


global::System.Console.WriteLine("Hello World"); 


备注 
命名 空间 别名 限定 符 可 以 是 global。 这 将 调用 全 局 命名 空间 中 的 查找 ， 而 不 是 在 别 
名 命名 空间 中 。 


更 多 信息 
有 关 如 何 使 用 :: 运算 符 的 示例 ， 请 参见 下 面 的 章节 : 
。 如 何 : 使 用 全 局 命名 空间 别名 (CH 编程 指南 ) 


CH 语言 规 泄 


有 关 详 细 信 息 ， 请 参阅 CH 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 


请 参阅 
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命名 空间 关键 字 (C# 参考 ) 
. 运算 符 (CH 参考 ) 

外 部 别名 (CH 参考 ) 


+ 运算 和 从 (CH 参考 ) 


+ 运算 符 既 可 作为 一 元 运算 符 也 可 作为 二 元 运算 符 。 


备注 
一 元 + 运算 符 是 为 所 有 数值 类 型 预定 义 的 。 对 数值 类 型 进行 一 元 + 运算 的 结果 就 是 
操作 数 的 值 。 


为 数值 类 型 和 字符 串 类 型 预定 义 了 二 元 + 运算 符 。 对 于 数值 类 型 ，+ 计算 两 个 操作 
数 之 和 。 当 其 中 的 一 个 操作 数 是 字符 串 类 型 或 两 个 操作 数 都 是 字符 串 类 型 时 ，+ 将 
操作 数 的 字符 串 表 示 形 式 串 联 在 一 起 。 


委托 类 型 也 提供 二 元 + 运算 符 ， 该 运算 符 执行 委托 串联 。 


用 户 定 义 的 类 型 可 重 载 一 元 + 运算 符 和 二 元 + 运算 符 。 对 于 整数 类 型 适用 的 运算 
对 枚 举 类 型 通常 也 适用 。 有 关 更 多 信息 ， 请 参见 运算 符 (CHES), 


class Plus 


{ 
static void Main() 
{ 
Console.WriteLine(-5); // unary plus 
Console.WriteLine(5 + 5); // addition 
Console.WriteLine(5 + .5); // addition 
Console.WriteLine("5" + "5"); // string concatenation 
Console.WriteLine(5.0 + "5"); // string concatenation 
// note automatic conversion from double to string 
j 
} 
Vas 
Output 
5 
10 
Sols 
55 
55 
2H 
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- 运算 符 (C# 参考 ) 


- 运算 符 既 可 作为 一 元 运算 符 也 可 作为 二 元 运算 符 。 


i eee 
BE o 


二 元 - 运算 符 是 为 所 有 数值 类 型 和 枚 举 类 型 预定 义 的 ， 其 功能 是 从 第 一 个 操作 数 中 
减 去 第 二 个 操作 数 。 


委托 类 型 也 提供 二 元 - 运算 符 ， 该 运算 符 执行 委托 移 除 。 
用 户 定义 的 类 型 可 重 载 一 元 - 运算 符 和 二 元 - 运算 符 。 有 关 更 多 信息 ， 请 参见 运算 
S (CH 参考 ) 。 


class MinusLinus 


{ 
static void Main() 
{ . 
int a = 5; 
Console.WriteLine(-a); 
Console.WriteLine(a - 1); 
Console.WriteLine(a - .5); 
} 
} 
/* 
Output: 
29 
4 
4.5 
Ae 
请 参阅 
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* 运算 符 (C#S4) 


人 指针 。 


备注 
所 有 数值 类 型 都 具有 预定 义 的 乘法 运算 符 。 
* 运算 符 还 用 来 声明 指针 类 型 和 取消 引用 指针 。 该 运算 符 只 能 在 不 安全 的 上 下 文中 
使 用 ， 通 过 unsafe 关键 字 的 使 用 来 表示 ， 并 且 需 要 /unsafe 编译 器 选项 。 取 消 引 用 
运算 符 也 称 为 间接 寻 址 运算 符 。 
用 户 定义 的 类 型 可 重 载 二 元 * 运算 符 〈 请 参见 operator) 。 重 载 二 元 运算 符 时 ， 也 
会 隐 式 重 载 相应 的 赋值 运算 符 〈 如 果 有 ) 。 
class Multiply 
static void Main() 
Console.WriteLine(5 * 2); 


Console.WriteLine(-.5 * .2); 
Console.WriteLine(-.5m * .2m); // decimal type 


j 
We 
Output 
10 
-0.1 
0.10 
we 


public class Pointer 


{ 
unsafe static void Main() 
1 . . 
int 1 = 5; 
int* j = &i; 
System.Console.WriteLine(*j); 
} 
} 
Ja 
Output: 
5 


nA 
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/ 运算 符 〈C# 参考 ) 


除法 运算 符 (/) 将 通过 第 二 个 操作 数 的 第 一 个 操作 数 。 所 有 数值 类 型 都 具有 预定 义 
的 除法 运算 符 。 


备注 
用 户 定义 的 类 型 可 重 载 / 运算 符 (请 参见 运算 符 ) 。 对 / 运算 符 进 行 重 裁 将 隐 式 重 


载 /= 运算 符 。 


两 个 整数 相 除 的 结果 始终 为 一 个 整数 。 例如 ，7 的 结果 /3 是 2。 要 确定 7 的 其 余 
部 分 /3， 使 用 余数 运算 符 (%) 。 若 要 获取 作为 有 理 数 或 分 数 的 商 ， 应 将 被 除数 或 
除数 设置 为 float 类 型 或 double 类 型 。 如 果 您 你 通过 将 数字 用 bae 如 
以 下 示例 所 示 表 示 被 除数 或 除数 为 小 数 ， 您 可 以 隐 式 指定 类 型 


示例 


class Division 


{ 
static void Main() 
{ 
Console.WriteLine("\nDividing 7 by 3."); 
// Integer quotient is 2, remainder is 1. 
Console.WriteLine("Integer quotient: CO TUS dece 
Console.WriteLine("Negative integer quotient: {0}", -7 / : 
Console.WriteLine("Remainder: ee V ees 
// Force a floating point quotient. 
float dividend = 7; 
Console.WriteLine("Floating point quotient: {O}", divide 
Console.WriteLine("\nDividing 8 by 5."); 
// Integer quotient is 1, remainder is 3. 
Console.WriteLine("Integer quotient: TO) B A Sl 
Console.WriteLine("Negative integer quotient: {0}", 8 / -! 
Console.WriteLine("Remainder: T0159 795 5) 
// Force a floating point quotient. 
Console.WriteLine("Floating point quotient: TOT 8 5 
} 
} 
// Output: 
//Dividing 7 by 3. 
//Integer quotient: 2 
//Negative integer quotient:  -2 
/ /Remainder : 1 
//Floating point quotient: 2.33333333333333 
//Dividing 8 by 5. 
//Integer quotient: 1 
//Negative integer quotient: -1 
/ /Remainder : 3 
//Floating point quotient: 1.6 
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Mo iz 


% 运算 符 在 将 其 第 一 
的 其 余部 分 运算 符 。 


备注 


用 户 定义 的 类 型 能 重 载 % 运算 符 (请 参 
EXAMEN. 


RA, 
class MainClass6 
{ 
static void 
if 
Console 
Console 
Console 
Console 
Console 
} 
} 
fs 
Output: 
1 
-1 
0.6 
0.6 
-1.2 
d 
aN 
t 


请 注意 舍 人 误差 与 双 精 度 类 


ae i 
CH 参考 
C# 编程 指南 
C# 运算 符 


S 


个 操作 数 后 


.WriteLine(-5.2 % 2.0); 


watt 〈《C# 参考 ) 


见 运算 符 )。 


Main() 

.WriteLine(5 % 2); // 
.WriteLine(-5 % 2); // 
-WriteLine(5.0 % 2.2); Yh 


.WriteLine(5.0m % 2.2m); // 


// 


型 。 


计算 其 余部 分 在 其 秒 钟 之 前 。 所 有 数字 类 型 预定 义 


当 重 载 时 二 元 运算 符 时 ，， 如 


int 

int 
double 
decimal 
double 


& 运算 符 (CHES) 


& 运算 符 既 可 作为 一 元 运算 符 也 可 作为 二 元 运算 符 。 

各 注 

一 元 & 运算 符 返 回 操 作 数 的 地 址 (EK unsafe 上 下 文 ) 。 

为 整 型 和 bool 类 型 预定 义 了 二 进 制 & 运算 符 。 对 于 整 型 ，& 计算 操作 数 的 逻辑 按 
位 “与 " ”对 于 bool 操作 数 ，& 计算 操作 数 的 逻辑 “与 ”; 也 就 是 说 ， 当 且 仅 当 两 个 操 
作 数 均 为 true 时 ， 结 果 才 为 true, 

& 运算 符 计 算 两 个 运算 符 ， 与 第 一 个 操作 数 的 值 无 关 。 例 如 : 


int i- 0; 
if (false & ++i == 1) 


{ 
// iis incremented, but the conditional 
// expression evaluates to false, so 
// this block does not execute. 

} 


用 户 定义 的 类 型 可 重 载 二 元 & 运算 符 (请 参见 operator) 。 对 于 整数 类 型 适用 的 
运算 对 枚 举 类 型 通常 也 适用 。 重 载 二 元 运算 符 时 ， 也 会 隐 式 重 载 相应 的 赋值 运算 符 
(如 果 有 ) 。 


class BitwiseAnd 


{ 
static void Main() 
{ 
// The following two statements perform logical ANDs. 
Console.WriteLine(true & false); 
Console.WriteLine(true & true); 
// The following line performs a bitwise AND of F8 (1111 1( 
// 3F (0011 1111). 
// 1111 1000 
// 0011 1111 
// --------- 
// 0011 1000 or 38 
Console.writeLine("0x{0:x}", Oxf8 & Ox3f); 
} 
} 
// Output: 
// False 
// True 
// 0x38 
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| za (CH 参考 ) 


Binary| 运算 符 是 为 整 型 和 bool 预定 义 的 。 对 于 整 型 ，| 计 算 操 作 数 的 按 位 “或 ”。 
于 bool 操作 数 ，| 计算 操作 数 的 逻辑 “或 ”; 也 就 是 说 ， 当 且 仅 当 两 个 操 (UAR S 
false 时 ， 结 果 才 为 false。 


备注 
用 户 定义 的 类 型 可 重 载 | 运算 符 (请 参见 运算 符 ) 。 
class OR 
{ 
static void Main() 
Console.WriteLine(true | false); // logical or 


Console.WriteLine(false | false); // logical or 
Console.WriteLine("Ox(0:x]", Oxf8 | Ox3f); // bitwise or 


C# 编程 指南 
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Aiwa (CH 参考 ) 


运算 符 是 为 整 型 和 bool 类 型 预定 义 的 。 


TN ", $F bool 操作 数 ，^ 将 计算 操作 数 的 退 
只 有 一 个 操作 数 为 true 时 ， 结 果 才 为 true, 


备注 


用 户 定义 的 类 型 可 重 载 ^ 运 
枚 举 类 型 通 弟 也 适用 。 


算 符 (请 参见 


class XOR 
1 


static void Main() 


( 


// Logical exclusive-OR 


// When one operand is true and the other is false, 


// returns True. 


运算 符 ) 。 


对 于 整 型 ，^ 将 计算 操作 数 的 按 
辑 “ 异 或 ”; 也 就 是 说 ， 当 且 仅 当 


对 于 整数 类 型 适用 的 运算 对 


exclus: 


Console.WriteLine(true ^ false); 

// When both operands are false, 

Console.WriteLine(false ^ false); 
// When both operands are true, exclusive-OR returns False 
Console.WriteLine(true ^ true); 


exclusive-OR returns False 


// Bitwise exclusive-OR 


// Bitwise exclusive-OR of 
Console.WriteLine("Bitwise 
// Bitwise exclusive-OR of 
Console.WriteLine("Bitwise 
// Bitwise exclusive-OR of 
Console.WriteLine("Bitwise 


// With more than one digit, 


// 10 
// ats 
// = 
// 01 


// Bitwise exclusive-OR of 
Console.WriteLine("Bitwise 


// Bitwise exclusive-OR of 
Console.WriteLine("Bitwise 


// Bitwise exclusive-OR of 


0 and 1 
result: 
© and 0 
result: 
1 and 1 
result: 


returns 1. 
{0}", Convert.ToString(( 
returns 0. 
{0}", Convert.ToString(( 
returns 0. 
{0}", Convert.ToString(( 


perform the exclusive-OR colur 


10 (2) and 11 (3) returns 01 (1 
result: {0}", Convert.ToString(t 


101 (5) and 011 (3) returns 110 
result: {0}", Convert.ToString(( 


1111 (decimal 15, hexadecimal F` 


// returns 1010 (decimal 10, hexadecimal A). 


Bitwise 
Bitwise 
Bitwise 
Bitwise 
Bitwise 
Bitwise 
Bitwise 
a 


Console.WriteLine("Bitwise result: {0}", Convert.ToString(( 


// Finally, bitwise exclusive-OR of 11111000 (decimal 248, 
// and 00111111 (decimal 63, hexadecimal 3F) returns 11000: 
// 199 in decimal, C7 in hexadecimal. 

Console.WriteLine("Bitwise result: {0}", Convert.ToString(( 


result: 
result: 
result: 
result: 
result: 
result: 
result: 


HOOR 


110 
1010 
11000111 





在 前 面 的 示例 中 ，0xf8 ^ Ox3f 的 计算 对 以 下 两 个 二 进 制 值 (分别 对 应 于 十 六 进 制 值 
F8 和 3F) 执行 按 位 “ 异 或 "运算 : 


1111 1000 
0011 1111 


“ 异 或 运算 的 结果 是 1100 0111， 即 十 六 进 制 值 C7。 


请 参阅 


C# 参考 


C# 编程 指南 


# 运算 符 


1 运算 符 (CH 参考 ) 


逻辑 非 运算 符 (!) 是 对 操作 数 求 反 的 一 元 运算 符 。 为 bool 定义 了 该 运算 符 ， 当 且 公 
当 操 作 数 为 false 时 才 返 回 true。 


备注 
用 户 定义 的 类 型 可 重 载 ! 运算 符 (请 参见 运算 符 ) o 
class MainClass4 


static void Main() 


Console.WriteLine(!true); 
Console.WriteLine(!false); 


CH 参考 
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~ 运算 和 从 (CH 参考 ) 


~ 运算 符 对 操作 数 执 行 按 位 求 补 运 算 ， 其 效果 相当 于 反 转 每 一 位 。 按 位 求 补 运 算 符 
是 为 int、uint、long 和 ulong 类 型 预定 义 的 。 
区 注意 


ee 有 关 更 多 信息 ， 请 参见 析 构 函数 (CH 编程 指 
E o 


各 注 
用 户 定义 的 类 型 可 重 载 ~ 运算 符 。 有 关 更 多 信息 ， 请 参见 operator。 对 于 整数 类 
型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 


class BWC 
1 


static void Main() 


int[] values = ( 0, 0x111, Oxfffff, Ox8888, 0x22000022 }; 
foreach (int v in values) 


Console.WriteLine("~Ox{0:x8} = Ox{1:x8}", v, ~v); 


} 

} 
j 
/* 
Output: 
-0x00000000 = Oxffffffff 
~0x00000111 = Oxfffffeee 
-Oxooofffff = OxfffO0000 
—0x00008888 = Oxffff7777 
—0x22000022 - Oxddffffdd 
A 
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= 运算 和 从 〈C# 参考 ) 


赋值 运算 符 (=) 将 右 操作 数 的 值 存储 在 左 操作 数 表 示 的 存储 位 置 、 属 性 或 索引 器 
中 ， 并 将 值 作为 结果 返回 。 操 作 数 的 类 型 必须 相同 《 即 右 操作 数 必须 可 以 隐 式 转换 
为 左 操作 数 的 类 型 ) 。 


备注 


不 能 重 载 赋值 运算 符 。 不 过 ， 可 为 类 型 定义 隐 式 转换 运算 符 ， 这 样 就 可 以 对 这 些 类 
型 使 用 赋值 运算 符 。 有 关 更 多 信息 ， 请 参见 使 用 转换 运算 符 (CH 编程 指南 ) 。 


class Assignment 
{ 
static void Main() 
{ 
double x; 
int i; 
L S 5; // int to int assignment 
x = i; // implicit conversion from int to double 
i = (int)x; // needs cast 
Console.WriteLine("i is {0}, x is {1}", i, x); 
object obj = i; 
Console. WriteLine("boxed value - (0), type is (1)", 
obj, obj.GetType()); 
i = (int)obj; 
Console.WriteLine("unboxed: {0}", i); 
} 
Vas 
Output: 
iis 5, X as 5 
boxed value = 5, type is System. Int32 
unboxed: 5 
we 


请 参阅 
CH 参考 


C# 编程 指南 
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< 运算 符 (CH 参考 ) 


所 有 数值 和 枚 举 类 型 都 定义 “小 于 "关系 运算 符 (<)， 如 果 第 一 个 操作 数 小 于 第 二 个 操 
作 数 ， 该 运算 符 返 回 true， 否 则 返回 false, 


备注 


用 户 定 义 的 类 型 可 重 载 < 运算 符 〈 请 参见 运算 符 ) 。 如 果 重 载 <， 则 还 必须 重 载 
>。 重 载 二 元 运算 符 时 ， 也 会 隐 式 重 载 相应 的 赋值 运算 符 〈 如 果 有 ) 。 


class LT 


{ 


static void Main() 


{ 
Console.WriteLine(1 < 1.1); 
Console.WriteLine(1.1 < 1.1); 
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> 运算 得 (C# 参考 ) 


所 有 数值 类 型 和 枚 举 类 型 都 定义 “大 于 ”关系 运算 符 >， 如 果 第 一 个 操作 数 大 于 第 二 
个 操作 数 ， 它 将 返回 true， 否 则 返回 false. 


备注 
用 户 定 义 的 类 型 可 重 载 > 运算 符 〈 请 参见 运算 符 ) 。 如 果 重 载 >， 则 还 必须 重 载 
<。 重 载 二 元 运算 符 时 ， 也 会 隐 式 重 载 相应 的 赋值 运算 符 〈 如 果 有 ) 。 


class GT 


{ 


static void Main() 


{ 
Console.WriteLine(1.1 > 1); 
Console.WriteLine(1.1 > 1.1); 


C# 编程 指南 
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?: AAN (CE 参考 ) 


条 件 运算 符 (?:) 根据 Boolean 表达 式 的 值 返回 两 个 值 之 一 。 下 面 是 条 件 运 算 符 的 语 


法 。 


condition ? first expression : second expression; 


备注 


condition 的 计算 结果 必须 为 true 或 false。 如 果 condition 为 true， 则 将 计算 
first expression 并 使 其 成 为 结果 。 如 果 condition 7; false， 则 将 计算 
second expression 并 使 其 成 为 结果 。 只 计算 两 个 表达 式 之 一 。 


first expression 和 second expression 的 类 型 必须 相同 ， 或 者 必须 存在 从 一 种 类 
型 到 另 一 种 类 型 的 隐 式 转换 。 


你 可 通过 使 用 条 件 运 算 符 表达 可 能 更 确切 地 要 求 if-else 构造 的 计算 。 例 如 ， 以 下 
代码 首先 使 用 if 语句 ， 然 后 使 用 条 件 运 算 符 将 整数 分 类 为 正 整数 或 负 整 数 。 


int input = Convert.ToInt32(Console.ReadLine()); 
string classify; 


// if-else construction. 
if (input > 0) 

classify = "positive"; 
else 

classify - "negative"; 


// ?: conditional operator. 


classify = (input > 0) ? "positive" : "negative"; 


条 件 运算 符 为 右 联 运算 符 。 表 达 式 a?b:c?d:e 作 为 a?b:(c?di:e) 而 非 (a? 
b:c)?d:e 进行 计算 。 


无 法 重 载 条 件 运算 符 。 


class ConditionalOp 


return x !- 0.0 ? Math.Sin(x) / x : 


Console.WriteLine(sinc(0.2)); 
Console.WriteLine(sinc(0.1)); 
Console.WriteLine(sinc(0.0)); 


{ 
static double sinc(double x) 
{ 
} 
static void Main() 
{ 
} 
} 
ffe 
Output: 


0.993346653975306 
0.998334166468282 
1 

“y 


CHES 
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1.0; 


++ 运算 条 〈C# 参考 ) 


递增 运算 符 (++) 将 操作 数 加 1。 递 增 运算 符 可 出 现在 操作 数 之 前 或 之 后 


第 一 种 形式 是 前 级 增 量 操作 。 该 操作 的 结果 是 操作 数 加 1 之 后 的 值 。 
第 二 种 形式 是 后 级 增 量 操作 。 该 运算 的 结果 是 操作 数 增加 之 前 的 值 。 
数值 类 型 和 枚 举 类 型 具有 预定 义 的 增 量 运算 符 。 用 户 定义 的 类 型 可 重 载 + 运算 
TR. 对 于 整数 类 型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 
//** operator 
class MainClass 
static void Main() 
double x; 
XA mr 
Console.WriteLine(++x); 
xX = 1.5; 


Console.WriteLine(x++); 
Console.WriteLine(x); 
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递减 运算 符 (--) 将 操作 数 减 1。 递 减 运算 符 可 出 现在 操作 数 之 前 或 之 后 : --variable 
和 variable--。 第 一 种 形式 是 前 级 减 量 操 作 。 该 运算 的 结果 是 操作 数 减 小 “之 后 "的 
值 。 第 二 种 形式 是 后 级 减 量 操作 。 该 运算 的 结果 是 操作 数 减 小 “之 前 ”的 值 。 


RE 
数值 类 型 和 枚 举 类 型 具有 预定 义 的 增 量 运算 符 。 
用 户 定义 的 类 型 可 重 载 -- 运算 符 (请 参见 运算 符 ) 。 对 于 整数 类 型 适用 的 运算 对 
枚 举 类 型 通常 也 适用 。 
class MainClass5 
static void Main() 
double x; 
~ = alee 
Console.WriteLine(--x); 
X= 5 


Console.WriteLine(x--); 
Console.WriteLine(x); 
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&& 运算 符 (Cf 参考 ) 


S (&&) 执行 其 bool 操作 数 的 逻辑 “与 运算， 但 仅 在 必要 时 才 计 算 第 
A 


备注 
操作 


X && y 


对 应 于 操作 


X & y 


, (B, MR xx false, y 不 会 计算 ， 因 为 ， 和 操作 的 结果 是 false, Dit y 的 值 
为 。 这 被 称 作为 “短路 "计算 。 


ARES RAH SV BA, (AM Rw RAMA AA true 与 false HBR, TEE 
些 限 制 条 件 下 也 被 视 为 条 件 逻 辑 运算 符 的 重 载 。 


在 下 面 的 示例 中 ，， 因 为 该 操作 数 返 回 false， 在 第 二 个 if 语句 的 条 件 表达 式 计算 
只 有 第 一 个 操作 数 。 


class LogicalAnd 


{ 
static void Main() 
{ 
// Each method displays a message and returns a Boolean va: 
// Methodi returns false and Method2 returns true. When & : 
// both methods are called. 
Console.WriteLine("Regular AND:"); 
if (Methodi() & Method2()) 
Console.WriteLine("Both methods returned true."); 
else 
Console.WriteLine("At least one of the methods returnec 
// When && is used, after Method1 returns false, Method2 i: 
// not called. 
Console.WriteLine("NnShort-circuit AND:"); 
if (Methodi() && Method2()) 
Console.WriteLine("Both methods returned true."); 
else 
Console.WriteLine("At least one of the methods returnec 
} 
static bool Methodi() 
{ 
Console.WriteLine("Methodi called."); 
return false; 
} 
static bool Method2() 
{ 
Console.WriteLine("Method2 called."); 
return true; 
} 
} 
// Output: 


// Regular AND: 

// Methodi called. 

// Method2 called. 

// At least one of the methods returned false. 


// Short-circuit AND: 
// Method1 called. 
// At least one of the methods returned false. 





有 关 详 细 信 息 ， 请 参阅 C# 语言 规范 。 该 语言 规范 是 CH 语法 和 用 法 的 权威 资料 。 
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|| 运算 符 (CH 参考 ) 


条 件 或 运算 符 (||) 执行 的 逻辑 或 其 bool 操作 数 。 如 果 第 一 个 操作 数 计算 结果 为 
true， 第 二 个 操作 数 对 象 不 会 计算 。 如 果 第 一 个 操作 数 计 算 结 果 为 false， 第 二 个 
运算 符 确 定 或 表达 式 整 体 是 否 计算 结 果 为 true x false. 


操作 

x Il y 
对 应 于 操作 
x | y 


但 ， oo y 不 会 计算 无 论 y， 的 值 ， 因 为 或 操作 是 true。 此 概念 称 为 “ 短 
路 计 


条 件 或 运算 符 无 法 重 载 ， 但 是 ， 公 共 逮 辑 运 算 符 和 AM 假 运算 符 的 重 载 ， 有 一 些 
限制 的 ， 也 将 条 件 逮 辑 运算 符 的 重 载 。 


在 下 面 的 示例 中 ， 表 达 式 中 使 用 的 [| 计算 只 有 第 一 个 操作 数 。 使 用 的 表达 式 | 计算 
两 个 操作 数 。 在 第 二 个 示例 中 ， 因 此 ， 如 果 两 个 操作 数 计算 ， 则 运行 时 会 发 生 异 
常 。 


class ConditionalOr 


{ 
// Methodi returns true. 
static bool Methodi() 


Console.WriteLine("Methodi called."); 
return true; 


j 


// Method2 returns false. 
static bool Method2() 


{ 
Console.WriteLine("Method2 called."); 
return false; 


static bool Divisible(int number, int divisor) 


{ 


// If the OR expression uses ||, the division is not attem[ 
// when the divisor equals O0. 
return !(divisor -- || number % divisor !- 0); 


// If the OR expression uses |, the division is attempted v 
// the divisor equals 0, and causes a divide-by-zero except 
// Replace the return statement with the following line to 
// see the exception. 


//return !(divisor == 0 | number % divisor != 0); 
} 
static void Main() 
{ 
// Example #1 uses Methodi and Method2 to demonstrate 
// short-circuit evaluation. 
Console.WriteLine("Regular OR:"); 
// The | operator evaluates both operands, even though afte 
// Methodi returns true, you know that the OR expression i: 
// true. 
Console.WriteLine("Result is {0}.\n", Method1() | Method2(: 
Console.WriteLine("Short-circuit OR:"); 
// Method2 is not called, because Method1 returns true. 
Console.WriteLine("Result is {0}.\n", Method1() || Method2\( 
// In Example #2, method Divisible returns True if the 
// first argument is evenly divisible by the second, and Fé 
// otherwise. Using the | operator instead of the || operat 
// causes a divide-by-zero exception. 
// The following line displays True, because 42 is evenly 
// divisible by 7. 
Console.WriteLine("Divisible returns {0}.", Divisible(42, | 
// The following line displays False, because 42 is not eve 
// divisible by 5. 
Console.WriteLine("Divisible returns {0}.", Divisible(42, : 
// The following line displays False when method Divisible 
// uses ||, because you cannot divide by 0. 
// If method Divisible uses | instead of ||, this line 
// causes an exception. 
Console.WriteLine("Divisible returns {0}.", Divisible(42, ( 
} 
} 
JS 
Output: 
Regular OR: 


Methodi called. 
Method2 called. 
Result is True. 


Short-circuit OR: 
Methodi called. 


Result is 


Divisible 
Divisible 
Divisible 
e 


True. 


returns True. 
returns False. 
returns False. 
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<< 运算 符 (C# 参考 ) 


左 移 运 算 符 (<<) 将 第 一 个 操作 数 向 左 移 动 第 二 个 操作 数 指定 的 位 数 。 第 二 个 操作 数 
的 类 型 必须 是 一 个 int & 或 具有 向 int 的 预定 义 隐 式 数 值 转换 的 类 型 。 


备注 
如 果 第 一 个 操作 数 是 int 或 uint (32 位 数 ) ， 则 移 位 数 由 第 二 个 操作 数 的 低 5 位 给 


出 。 也 就 是 实际 的 shift 计数 为 0 到 31 位 。 


如 果 第 一 个 操作 数 是 long 或 ulong (64 位 数 ) ， 则 移 位 数 由 第 二 个 操作 数 的 低 6 
位 给 出 。 也 就 是 实际 的 shift 计数 为 0 到 63 位 。 


不 在 移 位 后 第 一 个 操作 数 类 型 范围 内 的 任意 高 序 位 均 不 会 使 用 ， 低 序 空位 用 需 填 
充 。 移 位 操作 从 不 导致 浴 出 。 


用 户 定义 的 类 型 可 重 载 << 运算 符 〈 请 参见 操作 数 ) ; 第 一 个 操作 数 的 类 型 必须 为 


用 户 定义 的 类 型 ， 第 二 个 操作 数 的 类 型 必须 为 int。 EA-xGBEMN. 也 会 隐 式 
重 载 相应 的 赋值 运算 符 GORA) 。 


class MainClassi1 


t 
static void Main() 
{ . . 
int 1 = 1; 
long lg = 1; 
// Shift i one bit to the left. The result is 2. 
Console.WriteLine("Ox(0:x]", i << 1); 
// In binary, 33 is 100001*. Because the value of the five 
// bits is 1, the result of the shift is again 2\. 
Console.WriteLine("Ox{0:x}", i << 33); 
// Because the type of lg is long, the shift is the value ( 
// low-order bits. In this example, the shift is 33, and tl 
// lg is shifted 33 bits to the left. 
// In binary: 10 0000 0000 0000 0000 0000 0000 000( 
// In hexadecimal: 2 0 0 0 0 0 0 ( 
Console.WriteLine("Ox{0:x}", lg << 33); 
} 
} 
Vas 
Output: 
0x2 
0x2 
0x200000000 


i» 








注释 

请 注意 ，i<<1 和 i<<33 给 出 的 结果 相同 ， 因 为 1 和 33 的 低 序 5 位 相同 。 
请 参阅 

CH 参考 
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>> 运算 符 (CH 参考 ) 

右 移 运算 符 (>>) 将 第 一 个 操作 数 向 右 移动 第 二 个 操作 数 所 指定 的 位 数 。 

备注 

如 果 第 一 个 操作 数 为 int 或 uint (32 位 数 ) ， 则 移 位 数 由 第 二 个 操作 数 的 低 五 位 给 


出 (第 二 个 操作 数 & 0x1f) 。 


如 果 第 一 个 操作 数 为 long X ulong (64 位 数 ) ， 则 移 位 数 由 第 二 个 操作 数 的 低 六 
位 给 出 (第 二 个 操作 数 & 0x3f) 。 


如 果 第 一 个 操作 数 为 int 或 long， 则 右 移 位 是 算术 移 位 (高 序 空 位 设置 为 符号 

Eo eit Terres a Were ene E eet Rane 
0 o 

用 户 定义 的 类 型 可 重 载 >> 运算 符 ; 第 一 个 操作 数 的 类 型 必须 为 用 户 定义 的 类 型 ， 
第 二 个 操作 数 的 类 型 必须 为 int。 有 关 更 多 信息 ， 请 参见 operator。 重 载 二 元 运算 符 
时 ， 也 会 隐 式 重 载 相 应 的 赋值 运算 符 GRA). 

class RightShift 


static void Main() 


int i = -1000; 
Console.WriteLine(i >> 3); 


CH 参考 
C 编程 指南 
C# 运算 符 


== At (CH 参考 ) 


对 于 预定 义 的 值 类 型 ， 如 果 操 作 数 的 值 相 等 ， 则 相等 运算 符 (==) 返回 true, Amik 
E] false。 对 于 string 以 外 的 引用 类 型 ， 如 果 两 个 操作 数 引 用 同一 个 对 象 ， 则 == 返 
回 true。 对 于 string 类 型 ，== 比较 字符 串 的 值 。 


备注 


用 户 定义 的 值 类 型 可 重 载 == 运算 符 〈 请 参见 operator) 。 用 户 定义 的 引用 类 型 也 
可 重 载 == 运算 符 ， 尽 管 在 默认 情况 下 ， 无 论 对 于 预定 义 的 引用 类 型 还 是 用 户 定义 
的 引用 类 型 ，== 的 行为 都 与 上 面 描述 的 相同 。 如 果 重 载 ==， 则 还 必须 重 载 !=。 对 
于 整数 类 型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 


class Equality 


( 


static void Main() 


1 


// Numeric equality: True 
Console.WriteLine((2 + 2) == 4); 


// Reference equality: different objects, 
// same boxed value: False. 

object s = 1; 

object t = 1; 

Console.WriteLine(s == t); 


// Define some strings: 


Strang a = "hello"; 
string b = String.Copy(a); 
string c = "hello"; 


// Compare string values of a constant and an instance: Tri 
Console.WriteLine(a == b); 


// Compare string references; 
// ais a constant but b is an instance: False. 
Console.WriteLine((object)a == (object)b); 


// Compare string references, both constants 
// have the same value, so string interning 
// points to same reference: True. 
Console.WriteLine((object)a == (object)c); 
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l= 运算 符 (CH 参考 ) 


如 果 操 作 数 相等 ， 则 不 等 运算 符 (!=) 返回 false, £n), WE true。 为 所 有 类 型 
(包括 字符 串 和 对 象 ) 预定 义 了 不 等 运算 符 。 用 户 定义 的 类 型 可 重 载 != 运算 符 。 


备注 


对 于 预定 义 的 值 类 型 ， 如 果 操 作 数 的 值 不 同 ， 则 不 等 运算 符 (!=) 返回 true, Ax, 
返回 false。 对 于 string 以 外 的 引用 类 型 ， 如 果 两 个 操作 数 引 用 不 同 的 对 象 ， 则 != 
返回 true。 对 于 string 类 型 ，!= 比较 字符 串 的 值 。 


用 户 定义 的 值 类 型 可 重 载 != 运算 符 (请 参见 operator) 。 用 户 定义 的 引用 类 型 也 
JER! 运算 符 ， 尽 管 在 默认 情况 下 ， 无 论 对 于 预定 义 的 引用 类 型 还 是 用 户 定义 
的 引用 类 型 ，!= 的 行为 都 与 上 面 描述 的 相同 。 如 果 重 载 !=， 则 还 必须 重 载 ==。 对 
于 整数 类 型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 


class InequalityTest 


{ 
static void Main() 
{ 
// Numeric inequality: 
Console.WriteLine((2 + 2) != 4); 
// Reference equality: two objects, same boxed value 
object s = 1; 
object t = 1; 
Console.WriteLine(s != t); 
// String equality: same string value, same string objects 
string a = "hello"; 
string b = "hello"; 
// compare string values 
Console.WriteLine(a != b); 
// compare string references 
Console.WriteLine((object)a != (object)b); 
} 
} 
Js 
Output: 
False 
True 
False 
False 
ay 
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<= 运算 符 (C# 参考 ) 


所 有 数值 和 枚 举 类 型 都 定义 了 “小 于 等 于 ”关系 运算 符 (<=)， 如 果 第 一 个 操作 数 小 于 
或 等 于 第 二 个 操作 数 ， 则 该 运算 符 将 返回 true, ANRE false. 


各 注 
用 户 定 义 的 类 型 可 重 载 <= 运 算 符 。 有 关 更 多 信息 ， 请 参见 operator, MRBR 
<=， 则 还 必须 重 载 >=。 对 于 整数 类 型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 


class LTE 
1 


static void Main() 


{ 
Console.WriteLine(1 <= 1.1); 
Console.WriteLine(1.1 <= 1.1); 


CH 参考 
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>= A (CHO) 


所 有 数值 类 型 和 枚 举 类 型 都 定义 “大 于 等 于 "关系 运算 符 >=， 如 果 第 一 个 操作 数 大 于 
或 等 于 第 二 个 操作 数 ， 该 运算 符 将 返回 true， 否 则 返回 false. 


备注 


用 户 定 义 的 类 型 可 重 载 >= 运 算 符 。 有 关 更 多 信息 ， 请 参见 operator。 如 果 重 载 
>=， 则 还 必须 重 载 <=。 对 于 整数 类 型 适用 的 运算 对 枚 举 类 型 通常 也 适用 。 


class GTE 
{ 
static void Main() 
{ 
Console.WriteLine(1.1 >= 1); 
Console.WriteLine(1.1 >= 1.1); 
} 
} 
Vas 
Output 
True 
True 
n 
请 参阅 
CH 参考 
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+= 2 BH (C# 参考 ) 
加 法 赋值 运算 符 。 

备注 

使 用 += 赋值 运算 符 的 表达 式 ， 如 


x += y 


等 效 于 


ce cwm) 


不 同 的 是 x 只 计算 一 次 。 + 运算 符 的 含义 取决 于 x 和 的 类 型 《对 于 数值 操作 数 ， 
其 含义 为 相 加 ; 对 于 字符 串 操 作 数 ， 其 含义 为 串联 ， 等 等 ) 。 


不 能 直接 重 载 += 运算 符 ， 但 用 户 定 义 的 类 型 可 重 载 + 运算 符 (请 参见 
operator) 。 


+= 运算 符 还 用 于 指定 响应 事件 时 要 调用 的 方法 ; 这 类 方法 称 为 事件 处 理 程 序 。 在 
此 上 下 文中 使 用 += 运算 符 称 为 "订阅 事件 "。 有 关 更 多 信息 ， 请 参见 如 何 : 订阅 和 取 
消 订 阅 事件 (CH 编程 指南 ) 。 和 委托 (CH 编程 指南 ) o 


class AddAssigment 


{ 
static void Main() 
{ 
//addition 
int a = 5; 
a += 6; 
Console.WriteLine(a); 
//string concatenation 
string s = "Hello"; 
s += " world."; 
Console.WriteLine(s); 
} 
} 
Us 
Output: 
11 


Hello world 
A 
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+= 运算 符 (C# 参考 ) 


1016 


= 运算 符 (CH 参考 ) 


减法 赋值 运算 符 。 


不 同 的 是 x 只 计算 一 次 。 - 去 算 符 的 含义 取决 于 Xx 和 y 的 类 型 (例如 ， 对 于 数值 操 
作 数 ， 其 含义 为 相 减 ; 对 于 委托 操作 数 ， 其 含义 为 移 除 ) 。 


不 能 直接 重 载 -= 运算 符 ， 但 用 户 定义 的 类 型 可 重 载 - 运算 符 (请 参见 operator) o 


CH 中 也 使 用 -= 运算 符 来 取消 订阅 事件 。 有 关 更 多 信息 ， 请 参见 如 何 : 订阅 和 取消 
订阅 事件 (CH 编程 指南 ) o 


class MainClass3 


{ 
static void Main() 
( . 
int a = 5; 
a -= 6; 
Console.WriteLine(a); 


} 
Vas 
Output: 


1 
Hm 


“y 
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-= 运算 符 (C# 参考 ) 1018 


*= 运算 符 (C# 参考 ) 
二 元 乘法 赋值 运算 符 。 

备注 

使 用 *= 赋值 运算 符 的 表达 式 ， 如 


不 同 的 是 x 只 计算 一 次 。 为 数值 类 型 预定 义 了 * 运算 符 以 执行 乘法 操作 。 


不 能 直接 重 载 *= 运算 符 ， 但 用 户 定义 的 类 型 可 重 载 * 运算 符 GAS 
operator) 。 


class MainClass10 


{ 
static void Main() 
{ 
int a = 5; 
a *= 6; 
Console.WriteLine(a); 
} 
ie 
Output: 
30 
af 
请 参阅 
CH 参考 


C# 编程 指南 
C# 运算 符 


/= 运算 符 (CHESS) 
除法 赋值 运算 符 。 
备注 
使 用 /= 赋值 运算 符 的 表达 式 ， 如 
X /= y 
等 效 于 
X-2x/y 
不 同 的 是 x 只 计算 一 次 。 为 数值 类 型 预定 义 了 / 运算 符 以 执行 除法 操作 。 
不 能 直接 重 载 /= 运算 符 ， 但 用 户 定 义 的 类 型 可 重 载 /运算 符 ( 请 参见 operator) 。 
对 于 所 有 复合 赋值 运算 符 ， 隐 式 重 载 二 元 运算 符 会 重 载 等 效 的 复合 赋值 。 


class MainClass2 


{ 
static void Main() 
{ . 
int a = 5; 
a /= 6; 
Console.WriteLine(a); 
double b = 5; 
b /= 6; 
Console.WriteLine(b); 
} 
} 
Vas 
Output: 
0 
0 .833333333333333 
gr 
请 参阅 
C# 参考 
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/= 运算 符 (CR 参考 ) 1021 


%= iA (CH 参考 ) 
其 余部 分 赋值 运算 符 。 

备注 

使 用 %= 赋值 运算 符 的 表达 式 ， 例 如 


x %= y 


等 效 于 


Y= xy 


, [Bx 一 次 只 计算 。 % 运算 符 预定 义 为 数值 类 型 可 以 在 部 门 后 计算 其 余部 分 。 


不 能 直接 重 载 %= 运算 符 ， 但 是 ， 用 户 定义 的 类 型 能 重 载 % 运算 符 (请 参见 运算 符 
(C# 参考 ) )。 


class Test2 
static void Main() 
int a = 5; 


a % 3; 
Console.WriteLine(a); 


} 
} 
// Output: 2 


CH 2X 
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= 2B (CH $3) 


和 与 "赋值 运算 符 。 


备注 
使 用 &= 赋值 运算 符 的 表达 式 ， 例 如 


X &- y 


等 效 于 


X-X&y 


不 同 的 是 x 只 计算 一 次 。 & Bat BAR AAT RU BS iS, x bool 
操作 数 执 行 逻辑 “与 运算 。 


不 能 直接 重 载 &= 运算 符 ， 但 用 户 定义 的 类 型 可 重 载 二 元 & 运算 符 GER 


operator) 。 


class AndAssignment 
static void Main() 


int a = OxO0c; 

a &- 0x06; 
Console.WriteLine("Ox{0:x8}", a); 
bool b - true; 

b &- false; 

Console.WriteLine(b); 


} 

Va 

Output: 
0x00000004 
False 

T 
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&= 运算 符 (C# 参考 ) 1024 


|= 运算 符 (C# 参考 ) 
[或 "赋值 运算 符 。 

备注 

使 用 |= 冉 值 运算 符 的 表达 式 ， 例 如 


x |= y 


等 效 于 


xX-2-x|y 


不 同 的 是 x 只 计算 一 次 。 | 运算 符 对 整 型 操作 数 执行 按 位 逻辑 "或" 运算， 对 布尔 操 
作 数 执行 逻辑 “或 "运算 。 


不 能 直接 重 载 |= 运算 符 ， 但 用 户 定义 的 类 型 可 以 重 载 | 运算 行 ( 请 参 


operator) 。 


class MainClass7 
static void Main() 


int a = OxO0c; 

a |= 0x06; 
Console.WriteLine("Ox{0:x8}", a); 
bool b - true; 

b |= false; 

Console.WriteLine(b); 


} 

Jf 

Output: 
0x0000000e 
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|= 运算 符 (CR 参考 ) 1026 


= 运算 符 (C# 参考 ) 
“ 异 或 "赋值 运算 符 。 

备注 
下 列 形式 的 表达 式 


X A= y 


按 如 下 规则 计算 : 


XS XU 


不 同 的 是 x 只 计算 一 次 。^ 运算 符 对 整数 操作 数 执 行 按 位 “ 异 或 "运算 ， 对 bool 操作 
数 执 行 逻辑 “ 异 或 "运算 。 


不 能 直接 重 载 = 运算 符 ， 但 用 户 定 义 的 类 型 可 重 载 ^operator (请 参 
operator) 。 


class XORAssignment 


{ 
static void Main() 
1 H 
int a = OxO0c; 
a ^- 0x06; 
Console.WriteLine("Ox{0:x8}", a); 
bool b - true; 
b ^- false; 
Console.WriteLine(b); 
} 
} 
Jf 
Output: 
0x0000000a 
True 
i 
请 参阅 
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= 运算 符 〈C# 参考 ) 1028 


<<= i WA (C#S4) 
左 移 赋值 运算 符 。 

备注 

下 列 形 式 的 表达 式 

X <<= y 

按 如 下 规则 计算 : 


xX =X << y 


不 同 的 是 x 只 计算 一 次 。 << 去 算 符 将 x 向 左 移动 y 指定 的 位 数 。 


不 能 直接 重 载 <<= 运算 符 ， 但 用 户 定义 的 类 型 可 重 载 << 运算 符 (请 参见 
operator) 。 


class MainClass9 


{ 
static void Main() 
{ 
int a = 1000; 
a <<= 4; 
Console.WriteLine(a); 
} 
} 
Je 
Output 
16000 
i 
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>>= d AMA (CBE) 
右 移 赋值 运算 符 。 

备注 

下 列 形式 的 表达 式 


x >>= y 


按 如 下 规则 计算 : 


X =X >> y 


不 同 的 是 x 只 计算 一 次 。 >> 运算 符 根据 y 指定 的 量 对 x 进行 右 移 位 。 
不 能 直接 重 载 >>= 运算 符 ， 但 用 户 定义 的 类 型 可 重 载 >> 运算 符 (请 参见 
operator) 。 


示例 


class MainClass8 
static void Main() 
int a - 1000; 


a >>= 4; 
Console.WriteLine(a); 


C# 参考 
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-> 运算 符 〈C# 参考 ) 
-> 运算 符 将 指针 取消 引用 与 成 员 访 问 组 合 在 一 起 。 
各 注 
以 下 形式 的 表达 式 
X->y 
(其 中 x 为 T* 类 型 的 指针 ，y 为 下 的 成 员 ) 等 效 于 


(*x).y 


只 能 在 标记 为 不 安全 的 代码 中 使 用 -> 运算 符 。 
AEE HK -> 运算 符 。 

// compile with: /unsafe 

struct Point 


public int x, y; 


} 
class MainClass12 
{ 
unsafe static void Main() 
{ 
Point pt = new Point(); 
Point* pp = &pt; 
pp->x = 123; 
pp->y = 456; 
Console.writeLine("{0} {1}", pt.x, pt.y); 
} 
} 
Vas 
Output: 
123 456 
p 
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2? 运算 符 (CR 参考 ) 


?? 运算 符 称 作 null 合并 运算 符 。 如 果 此 运算 符 的 左 操作 数 不 为 null， 则 此 运算 符 
将 返回 左 操作 数 ; 否则 返回 右 操作 数 。 


备注 


可 以 为 null 的 类 型 可 以 表示 类 型 的 域 中 的 值 ， 或 者 值 可 以 是 未 定义 的 〈 在 这 种 情况 
F, ÆA null) 。 当 左 操作 数 具 有 一 个 值 为 null 的 可 以 为 null 的 类 型 时 ， 可 以 使 用 
?? 运算 符 的 语法 表现 力 来 返回 适当 的 值 ARER) 。 如 果 在 尝试 将 可 以 为 null 
值 的 类 型 分 配给 不 可 以 为 null 值 的 类 型 时 没有 使 用 ?? 运算 符 ， 则 会 生成 编译 时 错 
误 。 如 果 使 用 强制 转换 ， 且 当前 未 定义 可 以 为 null 值 的 类 型 ， 则 会 引发 
InvalidOperationException 异常 。 


有 关 详 细 人 和 信息， 请 参阅 可 以 为 null 的 类 型 (C# 编程 指南 ) 。 
即使 ?? 运算 符 的 两 个 参数 都 是 常量 ， 也 不 能 将 其 结果 视 为 常量 。 


class NullCoalesce 


{ 

static int? GetNullableInt() 

{ 
return null; 

} 

static string GetStringValue() 

{ 
return null; 

} 

static void Main() 

{ 
int? x = null; 
// Set y to the value of x if x is NOT null; otherwise, 
// if x = null, set y to -1. 
int y = x ?? -1; 
// Assign i to return value of the method if the method's i 
// is NOT null; otherwise, if the result is null, 
// default value of int. 
int i - GetNullableInt() ?? default(int); 
string s - GetStringValue(); 
// Display the value of s if s is NOT null; otherwise, 
// display the string "Unspecified". 
Console.WriteLine(s ?? "Unspecified"); 

} 

} 
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可 以 为 null 的 类 型 (CH 编程 指南 ) 
“提升 "的 准确 含义 是 什么 ? 


=> 运算 符 (C# 参考 ) 


=> 标记 称 作 lambda 运算 符 。 该 标记 在 lambda 表达 式 中 用 来 将 左 侧 的 输入 变量 与 
iE lambda 体 分 离 。Lambda 表达 式 是 与 匿名 方法 类 似 的 内 联 表 达 式 ， 但 更 加 
灵活 ; a 法 表示 的 LINQ 查询 中 广泛 使 用 了 Lambda 表达 式 。 有 关 更 多 信 
息 ， 请 参见 Lambda 表达 式 (CH 编程 指南 ) o 


下 面 的 示例 演示 两 种 查找 并 显示 最 短 的 字符 串 的 长 度 在 字符 数组 中 的 字符 串 。 该 示 
例 的 第 一 部 分 将 lambda 表达 式 (w => w.Length) words 于 数组 的 每 个 元 素 都 使 用 
Min<TSource> 方法 查找 最 小 长 度 。 为 了 进行 比较 ， 该 示例 的 第 二 部 分 演示 一 个 较 
长 的 解决 方案 使 用 查询 语法 执行 相同 操作 。 


string[] words = { "cherry", "apple", "blueberry" }; 


// Use method syntax to apply a lambda expression to each element 
// of the words array. 

int shortestWordLength = words.Min(w => w.Length); 
Console.WriteLine(shortestWordLength) ; 


// Compare the following code that uses query syntax. 
// Get the lengths of each word in the words array. 
var query = from w in words 

select w.Length; 
// Apply the Min method to execute the query and get the shortest - 
int shortestWordLength2 = query.Min(); 
Console.WriteLine(shortestWordLength2) ; 


// Output: 
// 5 
/7.5 


| ————— eee 
备注 
=> 运算 符 具有 与 赋值 运算 符 (=) 相同 的 优先 级 ， 并 且 是 右 结合 运算 符 。 


可 以 显 式 指 定 输入 变量 的 类 型 或 让 编译 器 推断 类 型 ; 仍 ， 该 变量 是 强 类 型 在 编译 
时 。 当 指定 类 型 时 ， 必 须 将 该 类 型 括号 中 的 名 称 和 变量 名 ， 如 下 例 所 示 。 





int shortestWordLength = words.Min((string w) -» w.Length); 


下 面 的 代码 演示 如 何 编写 采用 两 个 参数 标准 查询 运算 符 
Enumerable.Where<TSource> 的 超 加 载 的 lambda 表达 式 。 由 于 lambda 表达 式 
具有 多 个 参数 ， 必 须 括 在 括号 中 的 参数 。 第 二 个 参数 ，index， 表 示 当 前 元 素 的 索引 
集合 中 的 。 Where 表达 式 返 回 长 度 小 于 其 在 数组 的 索引 位 置 小 于 的 任何 字符 串 。 


static void Main(string[] args) 
{ 
string[] digits = { "zero", "one", "two", "three", "four", "fiy 
"six", "seven", “eight, "mine" }; 


Console.WriteLine("Example that uses a lambda expression:"); 
var shortDigits = digits.Where((digit, index) => digit.Length < 
foreach (var sD in shortDigits) 


if 
} 


// Compare the following code, which arrives at the same list « 
// digits but takes more work to get there. 
Console.WriteLine("\nExample that uses a for loop:"); 
List<string> shortDigits2 = new List<string>(); 

for (var i = 0; i < digits.Length; i++) 


Console.WriteLine(sD); 


if (digits[i].Length « i) 
shortDigits2.Add(digits[i]); 
j 


foreach (var d in shortDigits2) 


( 


Console.WriteLine(d); 


// Output: 

// Example that uses a lambda expression: 
// five 

// Six 

// seven 

// eight 

// nine 


// Example that uses a for loop: 
// five 
// six 


// seven 
// eight 
// nine 
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NULL 条 件 运 算 符 (C# 和 Visual Basic) 
用 于 在 执行 成 员 访 问 (?.) 或 索引 (PD 操作 之 前 ， 测 试 是 否 存在 NULL。 这 些 运算 符 
可 帮助 编写 更 少 的 代码 来 处 理 null 检查 ， 尤 其 是 对 于 下 降 到 数据 结构 。 
VB 
int? length = customers?.Length; // null if customers is null 


Customer first = customers?[0]; // null if customers is null 
int? count = customers?[0]?.Orders?.Count(); // null if customers, 


n—— Á—Á— Á— Á[ 
最 后 一 个 示例 演示 NULL 条 件 运 算 符 会 短路 。 如 果 条 件 成 员 访 问 和 索引 操作 链 中 的 


某 个 操作 返回 NULL， 则 该 链 其 余部 分 的 执行 将 停止 。 表 达 式 中 优先 级 较 低 的 其 他 
操作 将 继续 。 例 如 ， 以 下 的 示例 中 的 E 将 始终 执行 ，?? 和 == 操作 将 执行 。 


visualbasicANDcsharp 





A?.B?.C?[0] ?? E 
A?.B?.C?[0] == E 


NULL 条 件 成 员 访 问 的 另 一 个 用 途 是 使 用 非常 少 的 代码 以 线程 安全 的 方式 调用 委 
托 。 旧 方法 需要 如 下 所 示 的 代码 : 


VB 


var handler = this.PropertyChanged; 
if (handler !- null) 
handler(..) 


新 的 方法 是 要 简单 得 多 : 


visualbasicANDcsharp 


PropertyChanged?.Invoke(e) 


新 方法 是 线程 安全 的 ， 因 为 编译 器 生成 代码 以 评估 PropertyChanged ( 仅 一 次 ) , 
从 而 使 结果 保持 在 临时 变量 中 。 


你 需要 显 式 调用 Invoke 方法 ， 因 为 不 存在 NULL 条 件 委托 调用 语法 
PropertyChanged?(e)。 有 太 多 不 明确 的 分 析 情 况 来 允许 它 。 


有 关 详 细 信息 ， 请 参阅 C# RED. ABADE C# 语法 和 用 法 的 权威 资料 。 


有 关 详 细 信息 ， 请 参阅 Visual Basic 语言 参考 。 


请 参阅 


C# 参考 
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Visual Basic 语言 参考 


Visual Basic 编程 指南 


UJ 


ANAN 
)ZLU) 
ITU 


CH 4 Basta TD 


本 节 包 含有 关 以 下 CH 预 处 理 器 指令 的 信息 。 
Tif 

#else 

#elif 

#endif 

# define 

#undef 

#warning 

#error 

#line 

#region 

#endregion 

#pragma 

#pragma warning 

#pragma checksum 

请 参见 各 个 主题 有 关 更 多 信息 和 示例 。 


虽然 编译 器 没有 单独 的 预 处理 器 ， 本 节 中 介绍 的 义理 指令 ， 就 象 一 个 。 它 们 在 条 件 
编译 用 于 帮助 。 与 C 和 C++ 指 邻 不同， 不 能 使 用 这 些 指令 创建 宏 。 


预 处 理 器 指 含 必须 是 行 上 的 唯一 指令 
请 参阅 

CH 参考 
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Hif (CH BS) 


如 果 CH 编译 器 遇 到 最 后 面 跟 有 #endif 指令 的 #if 指令 ， 则 仅 当 指定 的 符号 已 定义 
时 ， 它 才 会 编译 这 两 个 指令 之 间 的 代码 。 与 C 和 C++ 不 同 ， 您 不 能 对 符号 赋予 数 
值 ; C# 中 的 #if 语句 是 Boolean， 仅 测试 符号 是 否 已 定义 。 例 如 ， 


#define DEBUG 
OA 
#if DEBUG 
Console.WriteLine("Debug version"); 
#endif 


使 用 运算 符 == (相等 ) 和 != (不 相等 ) 只 能 测试 出 结果 为 true 还 是 false, True 
表示 符号 已 定义 。 语 句 #if DEBUG 5 #if (DEBUG == true) 的 含义 相同 。 可 以 使 用 
(and), || (or) 和 (E) 计算 多 个 符号 是 否定 义 了 。 还 可 以 用 括号 将 符号 和 
运算 符 分 组 。 


备注 


结合 使 用 if 与 Helse. #elif. #endif. #define 和 Zundef 指令 ， 可 以 根据 一 个 或 多 
个 符号 是 否 存在 来 包含 或 排除 代码 。 在 编译 调试 版 本 的 代码 或 针对 特定 配置 进行 编 
译 时 ， 这 会 很 有 用 。 


以 Hif 指令 开始 的 条 件 指令 必须 用 #endif 指 邻 显 式 终 止 。 


#define 使 您 可 以 定义 一 个 符号 ， 通 过 将 该 符号 用 作 传 递 给 #if 指令 的 表达 式 ， 使 该 
表达 式 计 算 为 true。 


也 可 以 用 /define 编译 器 选项 来 定义 符号 。 可 以 用 #undef 来 取消 定义 符号 。 


用 /define 或 #define 定义 的 符号 与 具有 同一 名 称 的 变量 不 冲突 。 即 ， 不 应 将 变量 
名 传递 到 预 处 理 器 指令 ， 并 且 只 能 用 预 义理 器 指令 计算 符号 。 


用 #define 创建 的 符号 的 范围 是 在 其 中 定义 该 符号 的 文件 。 


// preprocessor if.cs 
#define DEBUG 

#define MYTEST 

using System; 

public class MyClass 
t 


static void Main() 


#if (DEBUG && !MYTEST) 
Console.WriteLine("DEBUG is defined"); 
Zelif (!DEBUG && MYTEST) 
Console.WriteLine("MYTEST is defined"); 
#elif (DEBUG && MYTEST) 
Console.WriteLine("DEBUG and MYTEST are defined"); 


#else 
Console.WriteLine("DEBUG and MYTEST are not defined"); 


#endif 
} 
} 


定义 DEBUG 和 MYTEST 


CH 参考 
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Helse (C# BS) 


Helse 人 允许 您 创建 复合 条 件 指 倒 ， 因 此 ， 如 果 前 面 的 ##if 或 (可 选 ) #elif 指令 中 的 
任何 表达 式 都 不 为 true， 则 编译 器 将 计算 #else 与 后 面 的 #endif 之 间 的 所 有 代 

码 。 

各 注 

#endif 必须 是 #else 之 后 的 下 一 条 预 处 理 器 指令 。 有 关 如 何 使 用 #else 的 示例 ， 请 
参见 tif, 

请 参阅 

C# 参考 
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Helif (C# BS) 


#elif 使 您 得 以 创建 复合 条 件 指 合 。 如 果 之 前 的 #if (CH 参考 ) 和 任何 之 前 的 ， 可 选 
的 ，#elif 关系 表达 式 的 值 为 true， 则 #elif 表 达 式 将 被 执行 。 如 果 #elif 表达 式 计 算 
为 true， 编 译 器 将 计算 位 于 #elif 和 下 一 个 条 件 指令 之 间 的 所 有 代码 。 例 如 : 


#define VC7 
70 acere 
#if debug 

Console.Writeline("Debug build"); 
#elif VC7 

Console.Writeline("Visual Studio 7"); 
#endif 


可 以 使 用 运算 符 == (相等 ) 、!= (不 相等 ) 8&8 C3) 及 | (或 ) 来 计算 多 个 符 
号 。 还 可 以 用 括号 将 符号 和 运算 符 分 组 。 


备注 
#elif 等 效 于 使 用 : 


Zelse 
Hif 


使 用 #elif 更 简单 ， 因 为 每 个 #if 都 需要 一 个 #endif (C£ 2) , m #elif 即使 在 没 
有 匹配 的 #endif 时 也 可 以 使 用 。 


有 关 如 何 使 用 #elif 的 示例 ， 请 参见 #if (C# 参考 ) 。 
请 参阅 
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#endif (CH 2) 


#endif 指定 以 #if 指令 开头 的 条 件 指令 的 结尾 。 例 如 ， 


#define DEBUG 
LA 
#if DEBUG 
Console.WriteLine("Debug version"); 
#endif 


各 注 

以 Hif 指令 开始 的 条 件 指 邻 必须 用 #endif 指令 显 式 终 止 。 有 关 如 何 使 用 #endif 的 
示例 ， 请 参见 Hif (C# 参考 ) 。 

请 参阅 

C# 参考 
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#define (C# 参考 ) 

使 用 define 定义 符号 。 当 您 将 符号 用 作 传 递 给 Hif 指令 的 表达 式 时 ， 此 表达 式 的 
计算 结果 为 true， 如 下 例 所 示 : 

# define DEBUG 


各 注 
8 注意 
不 能 像 在 C 和 C++ 中 的 通常 做 法 一 样 ， 使 用 #define 指令 来 声明 常数 值 。 最 好 


是 将 C# 中 的 常数 定义 为 类 或 结构 的 静态 成 员 。 如 果 具 有 多 个 像 这 样 的 常数 ， 可 
以 考虑 创建 一 个 单独 的 “Constants” 类 来 保存 这 些 常数 。 


符号 可 用 于 指定 编译 的 条 件 。 可 以 使 用 #if 或 #elif 来 测试 符号 。 还 可 以 使 用 
conditional 特性 执行 条 件 编译 。 


可 以 定义 符号 ， 但 是 无 法 对 符号 赋值 。 #define 指令 必须 在 使 用 任何 不 是 预 处 理 器 
指使 的 指 倒 之 前 出 现在 文件 中 。 


也 可 以 用 /define 编译 器 选项 来 定义 符号 。 可 以 用 #undef 来 取消 定义 符号 。 


用 /define 或 #define 定义 的 符号 与 具有 同一 名 称 的 变量 不 冲突 。 即 ， 不 应 将 变量 
名 传递 到 预 处 理 器 指令 ， 并 且 只 能 用 预 义理 器 指令 计算 符号 。 


用 #define 创建 的 符号 范围 是 在 其 中 定义 该 符号 的 文件 。 
如 以 下 示例 所 示 ， 您 必须 将 #define 指 倒置 于 文件 的 项 部 。 


Zdefine DEBUG 
//#define TRACE 
#undef TRACE 


using System; 
public class TestDefine 
{ 

static void Main() 

{ 
#if (DEBUG) 

Console.WriteLine("Debugging is enabled."); 

Zendif 
Hif (TRACE) 


Console.WriteLine("Tracing is enabled."); 
#endif 


} 


} 
// Output: 
// Debugging is enabled. 


有 关 如 何 取消 定义 符号 的 示例 ， 请 参见 #undef (C£ 参考 ) 。 


请 参阅 

CHES 

CH 编程 指南 

CH 预 处 理 器 指令 

const (C# 参考 ) 

How to: Compile Conditionally with Trace and Debug 
#undef (C4 参考 ) 

#if (CH BS) 


#undef (Cft 参考 ) 


#undef 使 您 可 以 取消 符号 的 定义 ， 以 便 通 过 将 该 符号 用 作 #if 指令 中 的 表达 式 ， 使 
表达 式 的 计算 结果 为 false。 


可 以 使 用 #define 指令 或 /define 编译 器 选项 定义 符号 。 在 使 用 任何 不 是 指令 的 语句 
之 前 ， 必 须 在 文件 中 使 用 #undef 18$. 


// preprocessor undef.cs 
// compile with: /d:DEBUG 
#undef DEBUG 

using System; 

class MyClass 


{ 
static void Main() 
{ 
#if DEBUG 
Console.WriteLine("DEBUG is defined"); 
#else 
Console.WriteLine("DEBUG is not defined"); 
#endif 
} 
} 
未 定义 DEBUG 
请 参阅 
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#warning (C# 参考 ) 
#warning 使 您 得 以 从 代码 的 特定 位 置 生成 一 级 警告 。 例如 : 


#warning Deprecated code in this method. 


备注 


#warning 通常 用 在 条 件 指令 中 。 也 可 以 用 #error (C£ 参考 ) 生成 用 户 定义 的 错 


示例 


// preprocessor warning.cs 
// CS1030 expected 

#define DEBUG 

class MainClass 


{ 
static void Main() 
{ 

#if DEBUG 


#warning DEBUG is defined 
#endif 


C# 参考 
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#error (C# 参考 ) 
#error 使 您 可 以 从 代码 中 的 特定 位 置 生成 错误 。 例 如 : 


#error Deprecated code in this method. 


4x 

#error 通常 用 在 条 件 指 兮 

也 可 以 用 #warning (C# 参考 ) 生成 用 户 定义 的 警告 。 
// preprocessor error.cs 
// CS1029 expected 


Zdefine DEBUG 
class MainClass 


{ 
static void Main() 
{ 

#if DEBUG 


#error DEBUG is defined 
#endif 
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#line (C4 BS) 


#line 使 您 可 以 修改 编译 器 的 行 号 以 及 (可 选 ) 错误 和 和 警告 的 文件 名 输出 。 下 面 的 
示例 说 明 如 何 报告 与 行 号 关联 的 两 个 警告 。 #line 200 指令 将 行 号 强制 设置 为 

200 (尽管 默认 行 号 为 #7) ， 在 执行 下 一 条 Hline 指令 之 前 ， 文 件 名 将 报告 
Zj"Special", #line default 指令 将 行 号 恢复 为 黑 认 行 号 ， 默 认 行 号 对 前 一 条 指令 重 
新 编号 的 行进 行 计数 。 


class MainClass 


( 


static void Main() 


#line 200 "Special" 
int i; // CS0168 on line 200 
int j; // CS0168 on line 201 
Zline default 
char c; // CS0168 on line 9 
float f; // CS0168 on line 10 
#line hidden // numbering not affected 
string s; 
double d; // CS0168 on line 13 


备注 


#line 指令 可 能 由 生成 过 程 中 的 自动 中 间 步 又 使 用 。 例 如 ， 如 果 行 从 原始 的 源 代 码 
文件 中 移 除 ， 但 是 您 仍 希 望 编译 器 基于 文件 中 的 原始 行 号 生成 输出 ， 则 可 以 移 除 

47, AERA #line 模拟 原始 行 号 。 

#line hidden 指令 对 调试 器 隐藏 若干 连续 的 行 ， 这 样 当 开发 人 员 在 逐 句 通过 代码 

at, TAB #line hidden 和 下 一 个 #line 指令 (假定 它 不 是 另 一 个 #line hidden 
iB) 之 间 的 所 有 行 。 此 选项 也 可 用 来 使 ASPNET 能 够 区 分 用 户 定义 的 代码 和 计 
人 

器 使 用 它 。 


#line hidden 指令 不 会 影响 错误 报告 中 的 文件 名 或 行 号 。 即 ， 如 果 在 隐藏 块 中 遇 到 
错误 ， 编 译 器 将 报告 当前 文件 名 和 错误 的 行 号 。 


#line filename 指令 指定 您 希望 出 现在 编译 器 输出 中 的 文件 名 。 黑 认 情 况 下 ， 使 用 
源 代码 文件 的 实际 名 称 。 文 件 名 必须 用 双 引 号 ("") 引起 来 且 前 面 必须 带 一 个 行 号 。 


源 代码 文件 可 以 具有 #line 指令 的 任何 编号 。 


示例 1 


下 面 的 示例 说 明 调 试 器 如 何 忽略 代码 中 的 隐藏 行 。 运 行 此 示例 时 ， 它 将 显示 三 行文 
A, (Hi, Si eee 您 将 看 到 调试 器 
忽略 了 隐 藏 行 。 还 请 im, 即使 在 隐藏 行 上 设置 断 点 ， 调 试 器 仍 会 忽略 它 Ko 


// preprocessor_linehidden.cs 
using System; 
class MainClass 


{ 


static void Main() 


Console.WriteLine("Normal line #1."); // Set break point he 
#line hidden 

Console.WriteLine("Hidden line."); 
#line default 

Console.WriteLine("Normal line #2."); 





请 参阅 
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#region (C# 参考 ) 


#region 使 您 可 以 在 使 用 Visual Studio 代码 编辑 器 的 大 纲 显 示 功 能 时 指定 可 展开 或 
折 受 的 代码 块 。 在 较 长 的 代码 文件 中 ， 能 够 折 秋 或 隐藏 一 个 或 多 个 区 域 会 十 分 便 
利 ， 这 样 ， 您 可 将 精力 集中 于 当前 处 理 的 文件 部 分 。 下 面 的 示例 演示 如 何 定义 区 


#region MyClass definition 
public class MyClass 


{ 
static void Main() 
{ 
} 

} 

#endregion 


备注 

#region 块 必须 以 #endregion 指令 终止 。 

#region 块 不 能 与 #if RBS. (He, ALS region REE Hif AA, SS #if 
HERET ffregion 块 内 。 
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#endregion (C# 参考 ) 


#endregion 标记 #region 块 的 结尾 。 例 如 : 


#region MyClass definition 
class MyClass 


{ 
static void Main() 
{ 
} 

} 

#endregion 
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#pragma (C# 参考 ) 


#pragma 为 编译 器 提供 特殊 的 指令 ， 以 说 明 如 何 编译 包含 休 注 的 文件 。 这 些 指令 
必须 是 编译 器 支持 的 指令 。 也 就 是 说 ， 不 能 使 用 #pragma 创建 自 定义 预 处 理 指 
D- Microsoft C£ 编译 器 支持 以 下 两 个 #pragma 指 今 : 

#pragma warning (C£ 参考 ) 


#pragma checksum (C£ 参考 ) 
语法 


#pragma pragma-name pragma-arguments 


pragma-name 
可 识别 杂 注 的 名 称 。 
pragma-arguments 


特定 于 条 注 的 参数 。 


请 参阅 
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#pragma warning (C£ 参考 ) 
#pragma checksum (C£ 参考 ) 


#pragma warning (C# 参考 ) 


#pragma warning 可 启用 或 禁用 某 些 警告 
吞 法 


#pragma warning disable warning-list 
#pragma warning restore warning-list 


和 警告 编号 的 逗号 分 隔 列 表 。 只 输入 数字 ， 不 包括 前 级 "CS"。 

当 没有 指定 警告 编号 时 ，disable 禁用 所 有 警告， 而 restore 启用 所 有 警告 。 

8 注意 

要 在 Visual Studio 中 查找 警告 编号 ， 请 先生 成 项 目 ， 再 在 “输出 ”窗口 中 查找 警 
告 编号 。 


// pragma warning.cs 
using System; 


Zpragma warning disable 414, 3021 
[CLSCompliant(false)] 
public class C 


( . . 
int 1 = 1; 
static void Main() 
{ 
} 
} 


#pragma warning restore 3021 
[CLSCompliant(false)] // CS3021 
public class D 
{ . . 

int 1 = 1; 

public static void F() 

t 

J 
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#pragma warning (C£ 参考 ) 
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#pragma checksum (C# 2) 


生成 源 文 件 的 校 验 和 ， 以 帮助 调试 ASP.NET 页 。 
语法 


#pragma checksum "filename" "(guid)" "checksum bytes" 


参数 


"filename" 

要 求 监视 更 改 或 更 新 的 文件 的 名 称 。 
"(guid]" 

文件 的 全 局 唯一 标识 符 (GUID). 
"checksum bytes" 


十 六 进 制 数 的 字符 串 ， 表 示 校 验 和 的 字 节 。 必 须 是 偶数 位 的 十 六 进 制 数 。 奇 数位 的 
十 六 进 制 数字 会 导致 编译 时 警告 ， 然 后 指令 被 忽略 。 


备注 


Visual Studio 调试 器 使 用 校 验 和 来 确保 找到 的 总 是 正确 的 源 。 编 译 器 计算 源 文件 的 
校 验 和 ， 然 后 将 输出 发 出 到 程序 数据 库 (PDB) 文件 。 最 后 ， 调 试 器 使 用 PDB 来 比 
较 它 为 源 文件 计算 的 校 验 和 。 


此 解决 方案 不 适用 于 ASP.NET 项 目 ， 因 为 算出 的 校 验 和 是 生成 的 源 文件 的 校 验 
和 ， 而 不 是 .aspx 文件 的 校 验 和 。 为 解决 此 问题 ，#pragma checksum 为 
ASP.NET 页 提供 了 校 验 和 支持 。 


在 Visual C£ 中 创建 ASP.NET 项 目 时 ， 生 成 的 源 文件 包含 .aspx 文件 (从 该 文件 
生成 源 文件 ) 的 校 验 和 。 然 后， 编译 器 将 此 信息 写 入 PDB 文件 。 

如 果 编 译 器 在 该 文件 中 没有 遇 到 #pragma checksum 指令 ， 它 将 计算 校 验 和 ， 然 
后 将 算出 的 值 写 信 PDB 文件 。 


class TestClass 








: static int Main() 
j #pragma checksum "file.cs" "{3673e4ca-6098-4ec1-890f-8fceb: 
} 
«| E 
请 参阅 
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C£ Compiler Options 


编译 器 生成 可 执行 (.exe) 文件 、 动 态 链接 库 (.dll) 或 者 代码 模块 (.netmodule)。 
每 个 编译 器 选项 均 以 两 种 形式 提供 : -option 和 /option。 本 文档 仅 显 示 /option 形 


工 vo 


在 Visual Web Developer 2008 中 ， 在 web.config 文件 中 设置 编译 器 选项 。 有 关 详 
细 信 息 ， 请 参阅 <compiler> 元 素 。 


本 节 内 容 


Command-ine Building With csc.exe 

有 关 从 命令 行 生成 Visual CH 应 用 程序 的 信息 。 

How to: Set Environment Variables for the Visual Studio Command Line 
提供 运行 vsvars32.bat 以 启用 命令 行 编译 的 步骤。 

部 署 C# 应 用 程序 

描述 用 于 部 署 CH 应 用 程序 的 选项 。 

按 类 别 列 出 的 CH 编译 器 选项 

编译 器 选项 的 分 类 列表 。 

按 字母 顺序 列 出 的 C# 编译 器 选项 

按 字母 顺序 排序 的 编译 器 选项 列表 。 


相关 章节 


“项 目 设计 器 ”->“ 生 成 ” 页 


设置 控制 项 目的 编译 、 生 成 和 调试 方法 的 属性 。 包 含有 关 在 Visual CH 项 目 中 自 定 
义 生成 步骤 的 信息 。 


默认 与 自 定义 生成 
有 关 生 成 类 型 和 配置 的 信息 。 
准备 和 管理 生成 


在 Visual Studio 开发 环境 内 生成 的 过 程 。 


Command-line Building With csc.exe 


可 以 通过 在 命令 行 上 键入 CH 编译 器 的 名 为 (csc.exe) 的 可 执行 文件 来 调用 CH 编译 
器 。 

如 果 您 使 用 Visual Studie 命令 提示 符 窗口 ， 所 有 必需 的 环境 变量 都 将 为 您 设置 

在 Windows 7 中 ， 您 可 以 通过 打开 开始 菜单 中 的 Microsoft Visual Studio 
VersionWisual Studio Tools 文件 夹 来 访问 这 个 窗口 .在 Windows 8 中 ， Visual 
Studio 命令 行 被 命名 为 开发 者 命令 提示 符 for VS2012， 您 可 以 在 开始 屏幕 搜索 到 
它 . 

ADR SERE i 兮 提示 符 窗 口 ， 必 须 调 整 路 径 ， 然 后 才能 从 计算 机 的 任何 子 目 录 调 
用 csc.exe。 您 还 必须 运行 vsvars32.bat 来 设置 适当 的 环境 变量 以 支持 命令 行 构 


建 。 有 关 vsvars32.bat 内 容 的 详细 信息 ， 包 括 如 何 找 到 它 以 及 运行 它 ， 请 参见 
How to: Set Environment Variables for the Visual Studio Command Line. 


如 果 您 使 用 的 计算 机 只 安装 有 Windows 软件 开发 包 (SDK)， 那 么 您 可 在 “SDK 命 
兮 提示 符 ” 上 使 用 CH 编译 器 。SDK 命令 提示 符 可 通过 “Microsoft .NET 
Framework SDK” 荣 单 选项 打开 


您 也 可 以 使 用 MSBuild 通过 编程 方式 生成 C# 程序 。 有 关 详 细 人 信息， 请 参 
# MSBuild, 


csc.exe 可 执行 文件 通常 位 于 系统 目录 下 的 Microsoft.NET\Framework_Version_ X 
件 天 中 。 根 据 每 台 计 算 机 上 的 实际 配置 ， 此 位 置 可 和 外 有 所 不 同 。 如 果 在 您 的 计算 机 
上 安装 了 不 止 一 个 .NET T Framework 的 版 本 ， 您 将 发 现 此 文件 的 多 个 版 本 。 有 关 此 
类 安装 的 更 多 信息 ， 请 参见 Determining Which Version of the .NET Framework Is 

Installed。 


s 提 示 


当 您 使 用 Visual Studio IDE 构建 项 目 时 ， 您 可 以 在 输出 窗口 显示 csc mpl 

及 与 之 关联 的 编译 器 选项 .要 显示 更 多 的 信息 ， 依 据 指 令 如 何 : 查看 、 保 存 和 配 
置 生成 日 志文 件 改变 日 志 数 据 的 见 余 版 本 -- 常规 或 M 在 您 的 项 目 重新 生成 
之 后 ， 在 输出 窗口 中 查找 csc 以 查看 所 调用 的 CE 编译 器 . 


e 命令 行 语 法 规则 
e 命令 行 示例 
e CH 编译 器 和 C++ 编译 器 输出 之 间 的 差异 
CH 编译 器 的 命 合 行 语法 规则 
在 解释 操作 系统 命 给 出 的 参数 时 ，C# 编译 器 使 用 下 列 规则 : 


参数 用 空白 分 隔 ， 空 白 可 以 是 一 个 空格 或 制 表 符 。 


字符 (^) 未 被 识别 为 转 义 符 或 者 分 隔 符 。 该 字符 在 被 传递 给 程序 中 的 argv 数 
组 前 ， 由 操作 系统 的 命令 行 分 析 器 进行 义理 。 


无 论 其 中 是 否 包含 空白 ， 带 双 引 号 的 字符 串 ("string") 均 被 解释 为 单个 参数 。 带 
引号 的 字符 串 可 以 府 入 在 参数 内 。 


前 面 有 反 斜 杠 的 双 引 号 (\") 被 解释 为 原 义 双 引 号 字符 ("o 
反 斜 杠 按 其 原 义 解释 ， 除 非 它 们 紧 位 于 双 引 号 之 前 。 


如 果 偶 数 个 反 斜 杠 后 跟 双 引号 ， 则 每 对 反 斜 枉 中 有 一 个 反 斜 杠 放置 在 argv 数 
组 中 ， 而 双 引 号 被 解释 为 字符 串 分 隅 符 。 


如 果 奇 数 个 反 斜 枉 后 跟 双 引号 ， 则 每 对 反 斜 枉 中 有 一 个 反 斜 杠 放置 在 argv 数 
组 中 ， 而 双 引 号 由 剩余 那个 反 斜 枉 进行 “ 转 义 "。 这 会 将 双 引 号 字符 (") 添加 到 
argv 中 。 


CH 编译 器 的 示例 命 分 


编译 File.cs 以 产生 File.exe : 
CSC File.cs 
编译 File.cs 以 产生 File.dll : 
csc /target:library File.cs 


编译 File.cs 并 创建 My.exe : 


csc /out:My.exe File.cs 


通过 使 用 优化 和 定义 DEBUG 符号 ， 编 译 当前 目录 中 的 所 有 C# 文件 。 输 出 为 
File2.exe : 


csc /define:DEBUG /optimize /out:File2.exe *.cs 


编译 当前 目录 中 的 所 有 CX 文件 ， 以 生成 File2.dll 的 调试 版 本 。 不 显示 任何 徽 
标 和 警告 : 


csc /target:library /out:File2.dll /warn:0 /nologo /debug *.cs 
Ei mE gh 





e 将 当前 目录 中 的 所 有 CH 文件 编译 为 Something.xyz (一 个 DLL) 


csc /target:library /out:Something.xyz *.cs 


Cil 编译 器 和 C++ 编译 器 输出 之 间 的 差异 


由 于 调用 CH 编译 器 的 结果 没有 创建 目标 文件 (.obj) ; 输出 文件 被 直接 创建 。 
此 ，C# 编译 器 不 需要 链接 器 。 


请 参阅 
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C# Compiler Options Listed by Category 

Main() 和 命令 行 参 数 (CH 编程 指南 ) 

命令 行 参数 (CH 编程 指南 ) 

如 何 : 显示 命令 行 参数 (CH 编程 指南 ) 

如 何 : 使 用 foreach 访问 命令 行 参数 (CH 编程 指南 ) 
Main() 返回 值 (C# 编程 指南 ) 


How to: Set Environment Variables for the 
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vsvars32.bat 文件 设置 适当 的 环境 变量 以 启用 命令 行 生 成 。 有 关 vsvars32.bat 的 详 
细 信 息 ， 请 参阅 知识 库 文章 Q248802。 


如 果 安 装 了 当前 版 本 Visual Studio 的 计算 机 上 也 安装 了 Visual Studio 的 早期 版 
本 ， 则 你 不 应 该 在 同一 命令 提示 符 窗 口中 运行 不 同 版 本 的 vsvars32.bat 或 
vevars32.bat. 


若 要 运行 VSVARS32.BAT 


1. 从 “开始 "菜单 ， 打 开 “VS2012 开发 者 命令 提示 ” 


2. 更 改 为 安装 目录 的 Program Files\Microsoft Visual Studio 
VersionNCommon7\Tools 或 Program Files (x86)\Microsoft Visual Studio 
VersionXCommon7 Tools 子 目录 。 


3. 通过 键入 VSVARS32 运行 VSVARS32.bat。 
在 小心 
VSVARS32.bat 在 各 个 计算 机 间 可 能 大 不 相同 。 不 要 使 用 另 一 台 计 算 机 中 的 


VSVARS32.bat 替换 丢失 或 损坏 的 VSVARS32.bat 文件 。 而 是 应 重新 运行 安装 
程序 以 蔡 换 丢失 的 文件 。 


请 参阅 
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Deployment of C# Applications 


当 您 完成 生成 您 的 C# 应 用 程序 之 后 ， 下 一 步 是 分 发 C# 应 用 程序 。C# 是 一 种 
NET 语言 ; 因此 ， 将 任何 CH 可 执行 文件 分 发 到 其 他 计算 机 上 要 求 在 每 台 执 行 计算 
机 上 安装 NET Framework (可 能 还 包括 特定 于 您 的 应 用 程序 的 其 他 依赖 项 ) 。 您 
有 各 种 可 用 于 分 发 .NET Framework 的 选项 。 有 关 概 述 ， 请 参见 针对 开发 人 员 的 部 
署 指 南 。 

将 完成 的 应 用 程序 移动 到 其 他 计算 机 上 的 过 程 通常 称 为 “部署 "。Microsoft 的 开发 环 
境 提供 了 部 署 机 制 ; 有 关 更 多 信息 ， 请 参见 部 署 应 用 程序 和 组 件 。 

如 果 您 主要 是 从 命令 行 生成 和 分 发 ， 您 可 能 需要 考虑 其 他 部 署 和 再 分 发 依赖 项 的 方 


N 
ILA o 


Command-line Building With csc.exe 
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下 列 编译 器 选项 按 类 别 排序 。 关 于 按 字母 顺序 排列 的 列表 ， 请 参阅 按 字母 顺序 列 出 
的 C# 编译 器 选项 。 


优化 
选项 目标 
/filealign 指定 输出 文件 中 各 节 的 大 小 。 
/optimize 启用 /禁用 优化 。 
输出 文件 
选项 目标 
/doc 指定 要 将 已 处 理 的 文档 注释 写 入 到 的 XML 文件 。 
/out 指定 输出 文件 。 
/pdb 指定 .pdb 文件 的 文件 名 和 位 置 。 
/platform 指定 输出 平台 。 


/preferreduilang ， 指 定编 译 器 输出 的 语言 。 


使 用 下 列 五 个 选项 之 一 指定 输出 文件 的 格 
/target X : /targetappcontainerexe, /targetexe, /target:library, /ta 
或 /target:winmdobj. 


/modulename: — 
«string» 指定 源 模块 的 名 称 


.NET Framework 程序 集 


选项 目标 
/addmodule 指定 一 个 或 多 个 模块 作为 此 程序 集 的 一 部 分 。 


/delaysign 指示 编译 器 添加 公 钥 ， 但 将 此 程序 集 保 留 为 未 签名 状态 
lkeycontainer  ， 指 定 加 密 密 钥 容器 的 名 称 。 

/keyfile 指定 包含 加 密 密 钥 的 文件 名 。 

Nib 指定 通过 /reference 的 方式 引用 的 程序 集 的 位 置 。 
/nostdlib 指示 编译 器 不 导入 标准 库 (mscorlib.dll). 

/reference 从 包含 程序 集 的 文件 导入 元 数据 。 

/analyzer 从 此 程序 集 (缩写 形式 : /a) 运行 分 析 器 


Cone ”命名 其 他 文件 ， 这 些 文件 不 会 直接 影响 代码 生成 ， 但 可 能 
ladditionalfile 分 析 器 用 于 生成 供 误 或 警告 、 


调试 /错误 检查 
选项 目标 
/bugreport 创建 一 个 文件 ， 其 中 包含 可 以 轻松 报告 bug 的 信息 。 
/checked 指定 渝 出 数据 类 型 边界 的 整数 算法 是 否 将 导致 运行 时 异常 。 
/debug 指示 编译 器 发 出 调试 信息 。 
/errorreport 设置 错误 报告 行为 。 
/fullpaths 指定 编译 器 输出 中 文件 的 绝对 路 径 。 
/nowarn 取消 编译 器 对 指定 警告 的 生成 。 
/warn 设置 警告 等 级 。 
/warnaserror 将 警告 提升 为 错误 。 


定 可 茶 用 特定 诊断 的 规则 集 文 件 。 


Iruleset:«file» 指 


ES: 


选项 目标 


/define 定义 预 处 理 器 符号 。 


选项 目标 
/link 使 指定 程序 集中 的 COM 类 型 信息 对 项 目 可 用 。 
/linkresource 创建 指向 托管 资源 的 链接 。 


/resource 
/win32icon 
/win32res 


杂项 


N 


p 


/baseaddress 
/codepage 
/help 
/highentropyva 


/langversion 


/main 

/noconfig 

/nologo 

/recurse 
/subsystemversion 
/unsafe 
/utf8output 
/parallel[+|-] 


Ichecksumalgorithm: 


«alg» 


已 过 时 的 选项 


| incremental | 启用 增 量 编 


将 NET Framework 3E 18 8x A El HH sc ft, 
指定 要 插入 到 输出 文件 的 .ico 文件 。 
指定 要 插入 到 输出 文件 的 Win32 资源 。 


目标 
指定 响应 文件 。 
列 出 到 stdout 的 编译 器 选项 。 
指定 要 加 载 DLL 的 首选 基 址 。 
指定 要 用 于 编译 中 所 有 源 代码 文件 的 代码 页 。 
列 出 到 stdout 的 编译 器 选项 。 
指定 可 执行 文件 支持 地 址 空间 布局 随机 化 (ASLR)。 


指定 语言 版 本 模式 : ISO-1, ISO-2, 3, 4. 5, 6 
默认 


指定 Main 方法 的 位 置 。 

指示 编译 器 不 使 用 csc.rsp 进行 编译 。 

禁止 显示 编译 器 横幅 信息 。 

搜索 要 编译 的 源 文件 的 子 目 录 。 

指定 可 执行 文件 可 以 使 用 的 子 系统 的 最 低 版 本 。 
启用 使 用 unsafe 关键 字 的 代码 编译 。 

显示 使 用 UTF-8 编码 的 编译 器 输出 。 

指定 是 否 使 用 并 发 生成 (+)。 


指定 用 于 计算 PDB 中 存储 的 源 文件 校 验 和 的 算法 。 
支持 的 值 为 : SHA1 (默认 值 ) 或 SHA256。 
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请 参阅 
C# Compiler Options 


C# Compiler Options Listed Alphabetically 


How to: Set Environment Variables for the Visual Studio Command Line 
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CZ Compiler Options Listed Alphabetically 


下 列 编 译 器 选项 按 字母 顺序 排序 。 有 关 按 类 别 排序 的 列表 ， 请 参阅 C# Compiler 
Options Listed by Category。 


选项 E 
@ 有 关 更 多 选项 ， 请 阅读 响应 文件 。 
fe 向 stdout 显示 用 法 消息 。 


/additionalfile 


命名 其 他 文件 ， 这 些 文 件 不 会 直接 影响 代码 生成 ， 但 可 


/addmodule 将 指定 的 模块 链接 到 此 程序 集中 

/analyzer 从 此 程序 集 (缩写 形式 : /a) 运行 分 析 器 

lappconfig 在 程序 集 绑 定时 指定 app.config 的 位 置 。 
/baseaddress 指定 要 生成 的 库 的 基 址 。 

fougreport a EUR 如 果 与 Jerrorreport:prompt x . 
/checked 使 编译 器 生成 浴 出 检查 。 

Gag Sumalgorithm: 指定 用 于 计算 PDB 中 存储 的 源 文件 校 验 和 的 算法 。 支 
/codepage 指定 在 打开 源 文 件 时 使 用 的 代码 页 。 

/debug 发 出 调试 信息 。 

/define 定义 条 件 编译 符号 。 

/delaysign 仅 使 用 强 名 称 密 钥 公 共 部 分 对 程序 集 进行 延迟 签名 。 
/doc 指定 要 生成 的 XML 文档 文件 。 

/errorreport 指定 如 何 处 理 内 部 编译 器 错误 ; prompt, send 或 none 
/filealign 指定 用 于 输出 文件 节 的 对 齐 方 式 。 

/fullpaths 使 编译 器 生成 完全 限定 的 路 径 。 

/help 向 stdout 显示 用 法 消息 。 

/highentropyva 指定 支持 高 ASLR。 


lincremental 
/keycontainer 


/keyfile 


启用 增 量 编译 [已 过 时 ]。 
指定 强 名 称 密 钥 容器 。 
指定 强 名 称 密 钥 文件 。 


CH 
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/langversion:<string> 
/lib 

/link 

/linkresource 


/main 


/moduleassemblyname 


/modulename: 
<string> 


/noconfig 

/nologo 

/nostdlib 

/nowarn 
/nowin32manifest 
/optimize 

/out 

/parallel[+|-] 
/pdb 


/platform 


/preferreduilang 
/recurse 
/reference 
/resource 
/ruleset:<file> 


/subsystemversion 
/target 


/unsafe 
/utf8output 
/warn 


/warnaserror 


指定 语言 版 本 模式 : ISO-1, ISO-2, 3. 4, 5. 6 或 默 
指定 要 在 其 中 搜索 引用 的 附加 目录 。 

使 指定 程序 集中 的 COM 类 型 信息 对 项 目 可 用 。 

将 指定 的 资源 链接 到 此 程序 集 。 

指定 包含 入 口 点 的 类 型 (忽略 所 有 其 他 可 能 的 入 口 点 ) 
指定 .netmodule 可 以 访问 非 公共 类 型 的 程序 集 。 


指定 源 模块 的 名 称 


指示 编译 器 不 自动 包含 CSC.RSP 文件 。 
取消 编译 器 版 权 消 息 。 

指示 编译 器 不 引用 标准 库 (mscorlib.dll). 

禁用 特定 的 警告 消息 

指示 编译 器 不 在 可 执行 文件 中 岁入 应 用 程序 清单 。 
启用 /禁用 优化 。 

指定 输出 文件 名 (默认 值 : 包含 主 类 的 文件 或 第 一 个 文 
指定 是 否 使 用 并 发 生成 (+)。 

指定 .pdb 文件 的 文件 名 和 位 置 。 


限定 此 代码 可 以 在 其 上 运行 的 平台 x86, Itanium, x6 
anycpu。 


指定 要 用 于 编译 器 输出 的 语言 。 

根据 通配符 规范 ， 包 括 当 前 目录 及 子 目 录 下 的 所 有 文件 
从 指定 的 程序 集 文件 引用 元 数据 。 

BRA SE BY 4 IR 

指定 可 禁用 特定 诊断 的 规则 集 文 件 。 

指定 可 执行 文件 可 以 使 用 的 子 系统 的 最 低 版 本 。 


使 用 下 列 四 个 选项 之 一 指定 输出 文件 的 格 
X : /targetappcontainerexe, /targetexe, /target:libr: 


允许 不 安全 代码 。 
以 UTF-8 编码 格式 输出 编译 器 消息 。 
设置 警告 等 级 (0-4)。 


将 特定 警告 报告 为 错误 。 
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/win32icon 对 输出 使 用 此 图 标 。 

/win32manifest 指定 自 定义 win32 清单 文件 。 

/win32res 指定 win32 资源 文件 (.res)。 
请 参阅 


C# Compiler Options 
C# Compiler Options Listed by Category 
How to: Set Environment Variables for the Visual Studio Command Line 


<compiler> 元 素 
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@ (C£ Compiler Options) 


@ 选项 使 您 可 以 指定 包含 编译 器 选项 和 要 编译 的 源 代码 文件 的 文件 。 
语法 


Qresponse file 


参数 


response file 
一 个 列 出 编译 器 选项 或 要 编译 的 源 代码 文件 的 文件 。 


备注 
编译 器 在 处 理 编译 器 选项 和 源 代 码 文件 时 将 它们 视 为 是 在 命令 行 上 指定 的 。 
若 要 在 一 次 编译 中 指定 多 个 响应 文件 ， 请 指定 多 个 响应 文件 选项 。 例 如 : 


Qfilei.rsp @file2.rsp 


在 响应 文件 中 ， 多 个 编译 器 选项 和 源 代 码 文件 可 以 出 现在 同一 行 中 。 单 个 编译 器 选 
项 的 指定 必须 出 现在 同一 行 中 〈 不 能 跨行 ) 。 响 应 文件 可 以 带 有 以 # 符号 开始 的 注 
释 。 

从 响应 文件 内 部 指定 编译 器 选项 就 如 同 在 命 合 行 发 出 这 些 命 分 。 有 关 更 多 信息 ， 请 
参见 从 命令 行 生成 。 

编译 器 在 遇 到 命令 选项 时 会 进行 处 理 。 因 此 ， 命 令 行 参 数 可 以 重 写 先前 在 响应 文件 
中 列 出 的 选项 。 反 之 ， 响 应 文件 中 的 选项 也 将 重 写 先前 在 命令 行 或 其 他 响应 文件 中 
列 出 的 选项 。 


CH 提供 csc.rsp 文件 ， 该 文件 与 csc.exe 文件 位 于 同一 目录 中 。 有 关 csc.rsp 的 更 


多 信息 ， 请 参见 /noconfig。 


不 能 在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 ， 也 不 能 以 编程 方式 对 其 进行 更 
改 。 


以 下 几 行 来 自 一 个 示例 响应 文件 : 


# build the first output file 
/target:exe /out:MyExe.exe sourcei.cs source2.cs 


请 参阅 


D 


C# Compiler Options 


laddmodule (C£ Compiler Options) 


此 选项 将 一 个 使 用 target:module 开关 创建 的 模块 添加 到 当前 的 编译 中 。 
语法 


/addmodule:file[;file2] 


参数 


file, file2 


包含 元 数据 的 输出 文件 。 该 文件 不 能 包含 程序 集 清单 。 若 要 导入 多 个 文件 ， 请 用 去 
号 或 分 号 分 隔 文 件 名 。 


备注 


运行 时 ， 所 有 用 /addmodule 添加 的 模块 必须 与 输出 文件 在 同一 目录 中 。 也 就 是 
说 ， 编 译 时 可 以 在 任何 目录 中 指定 模块 ， 但 是 三 运行 时 模块 必须 在 应 用 程序 目录 
中 。 如 果 模 块 在 运行 时 不 在 应 用 程序 目录 中 ， 您 将 遇 到 TypeLoadException。 


file 不 能 包含 程序 集 。 例 如 ， 如 果 输 出 文件 用 /targetmodule 创建 ， 则 其 元 数据 可 
以 用 laddmodule 导入 。 


如 果 输 出 文件 用 /target 选项 而 不 是 /target:module 创建 ， 则 其 元 数据 无 法 用 
/addmodule 导入 ， 但 是 可 以 用 /reference 导入 。 


此 编译 器 选项 在 Visual Studio 中 不 可 用 ; 项 目 不 能 引用 模块 。 另 外 ， 不 能 以 编程 方 
式 和 更 改 此 编译 器 选项 。 


编译 源 文件 input.cs 并 从 metad1.netmodule 和 metad2.netmodule 中 添加 元 数据 
来 产生 out.exe : 


csc /addmodule:metad1.netmodule;metad2.netmodule /out:out.exe input 





请 参阅 


C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


MSDN C# 编程 指南 & 参考 手册 2015 


多 文件 程序 集 
如 何 : 生成 多 文件 程序 集 


/addmodule (C£ Compiler Options) 1077 


lappconfig (CZ Compiler Options) 


lappconfig 编译 器 选项 使 CH 应 用 程序 能 够 在 程序 集 绑 定时 向 公共 语言 运行 时 
(CLR) 指明 程序 集 应 用 程序 配置 (app.config) 文件 的 位 置 。 


吾 法 


/appconfig:file 


~ 


以 选 。 包 含 程序 集 绑 定 设置 的 点 用 程序 配置 文件 。 
各 注 


lappconfig 的 一 种 用 途 是 升级 方案 ， 在 该 方案 中 ， 程 序 集 必须 同时 引用 特定 引用 程 
序 集 的 .NET Framework 版 本 和 .NET Framework for Silverlight 版 本 。 例 如 ， 以 
Windows Presentation Foundation (WPF) 编写 的 XAML 设计 器 可 能 必须 同时 引用 
设计 器 用 户 界面 的 WPF 桌面 和 Silverlight 附带 的 WPF 子 集 。 相 同 设计 器 程序 集 
必须 访问 这 两 个 程序 集 。 上 默认 情况 下 ， 单 独 引用 会 导致 编译 器 错误 ， 因 为 程序 集 绑 
定 将 这 两 个 程序 集 视 为 等 效 。 

lappconfig 编译 器 选项 使 您 能 够 通过 使 用 <supportPortability> 标记 指定 禁用 加 
认 行 为 的 app.config 文件 的 位 置 ， 如 下 面 的 示例 所 示 。 

<supportPortability PKT="7cec85d7bea7798e" enable="false"/> 


编译 器 将 该 文件 的 位 置 传递 给 CLR 的 程序 集 绑 定 逻辑 。 
8 注意 


如 果 您 要 使 用 Microsoft Build Engine (MSBuild) 生成 应 用 程序 ， 可 通过 向 
.csproj 文件 添加 属性 标记 来 设置 lappconfig 编译 器 选项 。 若 要 使 用 已 经 设置 在 
项 目 中 app.config 文件 ， 添 加 属性 标记 <UseAppConfigForCompiler> 
.csproj 文件 并 设置 其 值 到 true。 若 要 指定 一 个 不 同 的 app.config 文件 ， 添 力 

性 标记 <AppConfigForCompiler> 并 设置 其 值 到 文件 的 所 在 位 置 。 


下 面 的 示例 演示 一 个 app.config 文件 ， 它 使 应 用 程序 可 以 具有 对 任何 .NET 
Framework 程序 集 的 .NET Framework 实现 和 .NET Framework for Silverlight 实 
现 的 引用 ， 该 程序 集 存 在 于 两 个 实现 中 。 lappconfig 编译 器 选项 指定 此 


app.config 文件 的 位 置 。 


«configuration» 
«runtime» 


<assemblyBinding> 
«supportPortability PKT="7cec85d7bea7798e" enable="fal: 


<supportPortability PKT="31bf3856ad364e35" enable="fal: 
</assemblyBinding> 
</runtime> 
</configuration> 











图 





s 


y 


青 参 阅 
.NET Framework Assembly Unification Overview 


<supportPortability> 元 素 
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/baseaddress (C£ Compiler Options) 


/baseaddress 选项 使 您 可 以 指定 加 载 DLL 的 首选 基 址 。 有 关 为 何 和 何 时 使 用 此 选 
项 的 更 多 信息 Ny Ae $2 tz 高 应 用 开始 时 间 和 拉 里 Osterman 的 网 络 日 志 。 


语法 


/baseaddress:address 


参数 


address 


DLL 的 基 址 。 可 以 将 该 地 址 指定 为 十 进 制 、 十 六 进 制 或 八进制 数 。 
各 注 
DLL 的 默认 基 址 由 .NET Framework 公共 语言 运行 时 设置 。 


请 注意 : 该 地 址 中 低位 的 数 将 会 被 舍 人 。 例 如 ， 如 果 指 定 0x11110001， 它 将 被 舍 
AA 0x11110000. 


若 要 完成 DLL 的 签名 过 程 ， 请 结合 使 用 SN.EXE 和 -R 选项 。 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “ 生 成 ”属性 页 。 
3. 单 击 “高 级 "按钮 。 
4. 修改 “DLL 基 址 ”属性 。 
若 要 以 编程 方式 设置 此 编译 器 选项 ， 请 参见 BaseAddress。 


请 参阅 
ProcessModule.BaseAddress 


C£ Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 


/baseaddress (C£ Compiler Options) 1081 


/bugreport (C£ Compiler Options) 


指定 应 将 调试 信息 放 在 文件 中 ， 供 以 后 分 析 使 用 。 
语法 


/bugreport:file 


BB 

file 

要 包含 bug 报告 的 文件 的 名 称 。 

备注 

/bugreport 选项 指定 应 将 下 面 的 信息 放 在 je 中 : 
e. 编译 中 所 有 源 代码 文件 的 副本 。 
e. 编译 中 使 用 的 编译 器 选项 列表 。 


e 有 关 编 译 器 、 运 行 时 和 操作 系统 的 版 本 信息 。 


e 引用 的 程序 集 和 模块 (保存 为 十 六 进 制 数 ) ，.NET Framework 和 SDK 附带 
的 程序 集 除外 。 


e 编译 器 输出 (如果 有 ) 。 
。 将 会 提示 给 您 的 问题 的 说 明 。 
e 关于 考虑 问题 应 如 何 解 决 就 此 将 会 向 您 提示 ) 的 说 明 。 


如 果 此 选项 与 /errorreport:prompt 或 /errorreport:send 一 起 使 用 ， 则 文件 中 的 
= ERE & XZ Microsoft Corporation, 


由 于 所 有 源 代 码 文件 的 副本 都 将 放置 在 file 中 ， 因 此 可 能 需要 在 尽 可 能 短 的 程序 中 
重 现 所 怀疑 的 代码 缺陷 。 


此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 
注意 ， 生 成 文件 的 内 容 会 公开 源 代 码 ， 可 能 导致 意外 的 信息 泄露 。 


请 参阅 
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C£ Compiler Options 
/errorreport (C# Compiler Options) 
如 何 : 修改 项 目 属性 和 配置 设置 
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[checked (CZ Compiler Options) 


Ichecked 选项 指定 ， 不 在 checked 或 Unchecked 关键 字 的 范围 内 、 并 且 产 生 的 值 
超出 数据 类 型 范围 的 整数 算法 语句 是 否 将 导致 运行 时 异常 。 


语法 


/checked[+ | -] 


ex 

checked 或 unchecked 关键 字 范 围 内 的 整数 算法 语句 不 受 Ichecked 选项 的 影 
响 。 

如 果 不 在 checked 或 unchecked 关键 字 范 围 内 的 整数 算法 语句 产生 的 值 超出 数据 
类 型 范围 ， 并 且 编 译 中 使 用 了 /checked+ (/checked)， 则 该 语句 将 在 运行 时 导致 异 
常 。 如 果 编 译 中 使 用 的 是 /checked-， 则 该 语句 在 运行 时 不 会 导致 异常 。 

该 选项 的 默认 值 为 /checked-. 使 用 /checked- 的 一 个 方案 是 生成 大 型 点 用 程序 。 有 


时 自动 化 的 工具 用 于 生成 该 应 用 程序 ， 而 且 这 种 工具 可 以 将 /checked 自动 设置 为 
+。 可 通过 指定 /checked- 重 写 工 具 的 全 局 默认 值 。 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 

1 打开 项 目的 “属性 "页 。 有 关 更 多 信息 ， 请 参见 “项 目 设计 器 ->" 生 成 "页 (CH. 
2. 单 击 “ 生 成 ”属性 页 。 

3. 单 击 “ 高 级 ”按钮 。 

4. (Ek PERS bial Fis” Bre. 

若 要 以 编程 方式 访问 此 编译 器 选项 ， 请 参见 CheckForOverflowUnderflow. 


使 用 以 下 命令 编译 t2.cs。 命 令 中 /checked 的 使 用 指定 ， 任 何不 在 checked or 
unchecked 关键 字 范 围 内 以 及 导致 数据 类 型 以 外 值 的 结果 的 文件 中 的 整数 算法 语 
句 ， 都 会 在 测试 时 间 内 引发 异常 。 


csc t2.cs /checked 


请 参阅 
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如 何 : 修改 项 目 属性 和 配置 设置 


Introduction to the Project Designer 
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Icodepage (C£ Compiler Options) 
此 选项 指定 在 编译 期 间 ， 当 所 需 的 页 不 是 系统 当前 的 默认 代码 页 时 使 用 的 代码 页 。 
语法 


/codepage:id 


参数 

id 

编译 中 用 于 所 有 源 代码 文件 的 代码 页 的 ID。 
备注 


如 果 编 译 的 一 个 或 多 个 源 代码 文件 没有 被 创建 为 使 用 计算 机 上 的 默认 代码 页 ， 则 可 
以 使 用 /codepage 选项 指定 应 使 用 哪个 代码 页 。 /codepage 适用 于 编译 中 的 所 有 
源 代 码 文件 。 


如 果 源 代码 文件 是 用 计算 机 中 的 同一 有 效 代 码 页 创建 的 ， 或 者 是 用 UNICODE 或 
UTF-8 创建 的 ， 则 不 需要 使 用 /codepage。 


有 关 如 何 GetCPInfo 查找 系统 上 支持 哪些 代码 页 的 信息 。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 


请 参阅 
C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Idebug (C£ Compiler Options) 


debug 选项 使 编译 器 生成 调试 信息 并 将 其 放置 在 一 个 或 多 个 输出 文件 中 。 
语法 


/debug[+ | -] 
/debug:{full | pdbonly} 


+|- 

指定 + 或 只 指定 /debug 将 使 编译 器 生成 调试 信息 ， 并 将 这 些 信息 放置 在 一 个 程序 
数据 库 (.pdb 文件 ) 中 。 指 定 - (在 不 指定 /debug 时 有 效 ) 将 导致 不 创建 任何 调 
试 信息 。 

full | pdbonly 

指定 编译 器 生成 的 调试 信息 类 型 。full 参数 在 没有 指定 /debug:pdbonly 时 有 效 ， 
它 人 允许 将 调试 器 附加 到 正在 运行 的 程序 。 指 定 pdbonly 人 允许 在 调试 器 中 局 动 程序 时 
进行 源 代 码 调 试 ， 但 仅 在 正在 运行 的 程序 附加 到 调试 器 时 才 显 示 汇 编程 序 。 


备注 

使 用 该 选项 创建 调试 版 本 。 如 果 未 指定 /debug、/debug+ 或 /debug:full， 则 无 法 
调试 程序 的 输出 文件 。 

如 果 使 用 /debug:full， 请 注意 /debug:full 可 能 会 对 JIT 优化 代码 的 速度 和 大 小 有 


一 些 影响 ， 并 且 可 能 会 稍微 影响 代码 质量 。 我 们 建议 在 生成 发 布 代码 时 使 用 
/debug:pdbonly 或 不 使 用 PDB。 


二 
Ef TER 


Idebug:pdbonly 和 /debug:full 的 一 个 区 别 是 : 使 用 /debug:full 时 ， 编 译 器 
会 发 出 DebuggableAttribute， 用 于 通知 JIT 编译 器 有 可 用 的 调试 信息 。 因 此 ， 
如 果 使 用 /debug:full， 而 代码 中 包含 设置 为 false 的 DebuggableAttribute， 则 


会 发 生 错 误 。 
有 关 如 何 配置 应 用 程序 的 调试 性 能 的 信息 ， 请 参见 使 映像 更 易于 调试 。 
若 要 更 改 .pdb 文件 的 位 置 ， 请 参见 /pdb (C£ Compiler Options), 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “生成 ”属性 页 。 

3. 单 击 “高 级 ”按钮 。 

4. 修改 “调试 信息 ”属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 DebugSymbols。 
将 调试 信息 放置 在 输出 文件 app.pdb 中 : 


csc /debug /pdb:app.pdb test.cs 
请 参阅 


C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Idefine (C# Compiler Options) 


Idefine 选项 将 name 定义 为 程序 的 所 有 源 代 码 文 件 中 的 一 个 符号 。 
语法 


/ define:name[;name2] 


参数 


name, name2 


要 定义 的 一 个 或 多 个 符号 的 名 称 。 


备注 


使 用 /define 选项 与 使 用 #define 预 处 理 器 指令 具有 相同 的 效果 ， 不 同 点 在 于 编译 
器 选项 对 项 目 中 的 所 有 文件 都 有 效 。 在 源 文件 中 的 #undef 指令 移 除 定义 之 前 ， 符 
号 在 源 文件 中 始终 保持 已 定义 状态 。 使 用 /define 选项 时 ， 一 个 文件 中 的 #undef 18 
兮 不 会 影响 到 项 目 中 的 其 他 源 代码 文件 。 


可 以 将 用 该 选项 创建 的 符号 与 #if、#else、#elif 和 #endif 一 起 使 用 ， 以 按 条 件 编译 
源 文件 。 


Id 是 /define 的 缩写 形式 。 
通过 使 用 分 号 或 喜 号 分 隔 符 号 名 称 ， 可 以 使 用 /define 定义 多 个 符号 。 例 如 : 


/ define:DEBUG; TUESDAY 


CH 编译 器 自身 没有 定义 可 以 在 源 代 码 中 使 用 的 符号 或 宏 ; 所 有 符号 必须 是 用 
户 定义 的 。 
8 注意 


与 C++ 这 样 的 语言 相同 ，C##define 不 允许 给 符号 赋值 。 例 如 ， 不 能 使 用 
#define 创建 宏 或 定义 常数 。 如 果 您 需要 定义 常数 ， 请 使 用 enum 变量 。 如 果 
您 希望 创建 C++ 样式 的 宏 ， 请 考虑 其 他 方式 ， 例 如 泛 型 。 由 于 宏 有 容易 出 错 的 
坏 名 声 ， 因 此 CH 不 允许 使 用 宏 ， 而 是 提供 了 其 他 更 安全 的 选择 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 


2. 在 “生成 ”选项 卡 上 ， 键 入 要 在 “条 件 编译 符号 ” 框 中 定义 的 符号 。 例 如 ， 如 果 要 
使 用 下 面 的 代码 示例 ， 只 需 在 文本 框 中 键入 xx, 


有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 DefineConstants。 


// preprocessor define.cs 

// compile with: /define:xx 
// or uncomment the next line 
// #define xx 

using System; 

public class Test 


{ 
public static void Main() 
{ 
Hif (xx) 
Console.WriteLine("xx defined"); 
#else 
Console.WriteLine("xx not defined"); 
#endif 
} 
} 
请 参阅 


C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Idelaysign (C£ Compiler Options) 


此 选项 将 使 编译 器 在 输出 文件 中 保留 空间 ， 以 便 以 后 添加 数字 签名 。 


/delaysign[ + | - ] 


+|- 


如 果 需 要 完全 签名 的 程序 集 ， 则 使 用 /delaysign-。 如 果 只 想 将 公 钥 放 在 程序 集 
中 ， 则 使 用 /delaysign+。 默 认 值 为 /delaysign-。 


备注 
如 果 不 与 /keyfile 或 /keycontainer 一 起 使 用 ，/delaysign 选项 将 无 效 。 


如 果 要 求 完 全 签名 的 程序 集 ， 编 译 器 将 对 包含 清单 (程序 集 元 数据 ) 的 文件 进行 散 
列 处 理 ， 并 用 私 钥 对 该 散 列 数据 进行 签名 。 产生 的 数字 签名 存储 在 包含 清单 的 文件 
中 。 当 果 程 序 集 的 签名 延迟 时 ， 编 译 器 将 不 会 计算 和 存储 签名 ， 但 会 在 文件 中 保留 
空间 以 便 以 后 添加 签名 。 


例如 ， 使 用 /delaysign+ 将 人 允许 测试 人 员 把 程序 集 放 入 全 局 缓存 中 。 测 试 完成 后 ， 
可 以 通过 使 用 程序 集 链接 器 实用 工具 将 私 钥 放 入 程序 集中 对 程序 集 进 行 完全 签名 。 


有 关 更 多 信息 ， 请 参见 创建 和 使 用 具有 强 名 称 的 程序 集 和 延迟 为 程序 集 签名 。 
在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 

1， 打开 项 目的 “属性 ”页 。 

2. 修改 “ 仅 延 迟 签 名 ”属性 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 DelaySign。 

请 参阅 


C£ Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 
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/doc (C£ Compiler Options) 


/doc 选项 允许 在 XML 文件 中 放置 文档 注释 。 


/doc:file 


参数 

file 

XML 的 输出 文件 ， 由 编译 的 源 代码 文件 中 的 注释 填充 。 

各 注 

在 源 代码 文件 中 ， 可 处 理 以 下 内 容 之 前 的 文档 注释 ， 并 将 其 添加 到 XML 文件 中 : 
e 用 户 定义 的 类 型 ， 如 class、delegate 或 interface 
e 成 员 ， 如 字段 、 事 件 、 属 性 或 方法 


包含 Main 的 源 代码 文件 首先 输出 到 XML. 


若 要 将 生成 的 xm 文件 用 于 Intellisense 功 能 ， 请 使 该 xml 文件 的 文件 名 与 要 支持 
的 程序 集 同 名 ， 然 后 确保 该 xml 文件 放 入 与 该 程序 集 相 同 的 目录 中 。 这 样 ， 在 
Visual Studio 项 目 中 引用 程序 集 时 ， 也 可 找到 该 xml 文件 。 有 关 更 多 信息 ， 请 参 
见 提供 代码 注释 。 


除非 用 /target:module 进行 编译 ， 否 则 file 将 包含 <assembly></assembly>， 以 指 
定 包 含 编 译 输出 文件 的 程序 集 清 单 的 文件 名 。 
区 注意 
/doc 选项 适用 于 所 有 输入 文件 ; 或 者 ， 如 果 此 选项 是 在 “项 目 设置 "中 设置 的 ， 则 
适用 于 项 目 中 的 所 有 文件 。 若 要 禁用 与 特定 的 文件 或 代码 段 的 文档 注释 相关 的 


警告 ， 请 使 用 #pragma warning. 


有 关 从 代码 中 的 注释 生成 文档 的 方法 ， 请 参见 建议 的 文档 注释 标记 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 生 成 ”选项 卡 。 

3. 修改 “XML 文档 文件 "属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 DocumentationFile。 


请 参阅 
C£ Compiler Options 
如 何 : 修改 项 目 属 性 和 配置 设置 


lerrorreport (C£ Compiler Options) 


使 用 此 选项 可 以 方便 地 向 Microsoft 报告 CH 内 部 编译 器 错误 。 
8 注意 


在 Windows Vista 和 Windows Server 2008 上 ， 为 Visual Studio 做 出 的 错误 
告 设置 不 会 替代 通过 Windows 错误 报告 (WER) 做 出 的 设置 。WER 设置 始 res 
先 于 Visual Studio 的 错误 报告 设置 。 


BiB 


/errorreport:( none | prompt | queue | send } 


none 
不 收集 有 关内 部 编译 器 错误 的 报告 ， 或 不 向 Microsoft 发 送 报告 。 
prompt 


当 您 收 到 内 部 编译 器 错误 时 ， 提 示 您 发 送 报告 。 在 开发 环境 中 编译 应 用 程序 
时 ，prompt 是 默认 值 。 


queue 


对 错误 报告 进行 排队 。 当 使 用 管理 凭据 登录 时 ， 可 以 报告 自 上 次 登录 以 来 出 现 的 任 
何故 障 。 如 果 每 三 天 出 现 一 次 以 上 故障 ， 则 将 不 提示 发 送 故 障 报告 。 在 命令 行 编译 
应 用 程序 时 ，queue 是 默认 值 。 


send 


自动 向 Microsoft 发 送 内 部 编译 器 错误 报告 。 若 要 启用 此 选项 ， 必 须 先 同意 
Microsoft 数据 收集 策略 。 首 次 在 计算 机 上 指定 /errorreport:send 时 ， 编 译 器 消息 
将 引导 您 访问 包 售 Microsoft 数据 收集 策略 的 网 站 。 


此 选项 取决 于 注册 表 设 置 。 有 关 在 注册 表 中 如 何 设置 相应 值 的 信息 ， 请 参见 MSDN 
网 站 上 How to Turn on Automatic Error Reporting in Visual Studio 2008 
Command-line Tools (如 何在 Visual Studio 2008 的 命令 行 工 具 中 打开 自动 错误 报 
告 ) 。 


备注 


当 编 译 器 无 法 处 理 源 代 码 文件 时 ， 将 导致 内 部 编译 器 错误 B S AE ICE 时 ， 
编译 器 不 生成 输出 文件 或 可 用 来 修复 代码 的 任何 有 用 的 诊 


在 以 前 的 版 本 中 ， 当 收 到 E 时 ， 最 好 联系 Microsoft 产品 支持 服务 以 报告 问题 。 
现在 通过 使 用 /errorreport， 您 可 以 向 Visual C£ 团队 提供 ICE 信息。 错误 报告 有 
助 于 改进 将 来 的 编译 器 版 本 。 


用 户 发 送 报告 的 能 力 取决 于 计算 机 和 用 户 策略 权限 。 
调试 器 有 关 错 误 的 更 多 信息 ， 参 见 Dr Watson 的 说 明 (Drwtsn32.exe) 的 工具 窗 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 

1. 打开 项 目的 “属性 ”页 。 有 关 详 细 信 息 ， 请 参阅 “项 目 设 计 器 ”->" 生 成 "页 (CH). 
2. 单 击 “ 生 成 ”属性 页 。 

3. 单 击 “ 高 级 "按钮 。 

4. 修改 “内 部 编译 器 错误 报告 ”属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参阅 ErrorReport。 


请 参阅 


C# Compiler Options 


Ifilealign (C£ Compiler Options) 


Ifilealign 选项 使 您 可 以 指定 输出 文件 中 的 节 大 小 。 
语法 


/filealign:number 


参数 


number 

指定 输出 文件 中 节 大 小 的 值 。 有 效 值 为 512、1024、2048、4096 和 8192。 这 些 值 
字 节 为 单位 。 

各 注 

每 个 节 将 在 是 /filealign 值 的 倍数 的 边界 上 对 齐 。 没 有 固定 的 默认 值 。 如 果 未 指定 

/filealign， 则 公共 语言 运行 时 在 编译 时 将 选取 一 个 默认 值 。 


通过 指定 节 的 大 小 ， 可 以 影响 输出 文件 的 大 小 。 修 改 节 的 大 小 可 能 对 将 在 较 小 设备 
上 和 运行 的 程序 有 用 。 


使 用 DUMPBIN 查看 有 关 输 出 文件 中 的 节 信 息 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 生 成 ”属性 页 。 

3. 单 击 “ 高 级 ”按钮 。 

4. 修改 “文件 对 齐 ” 属 性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 FileAlignment。 


请 参阅 


C£ Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 


/filealign (C# Compiler Options) 1098 


/fullpaths (CZ Compiler Options) 


Ifullpaths 选项 可 使 编译 器 在 列 出 编译 错误 和 和 警告 时 指定 文件 的 完整 路 径 


语法 
/fullpaths 
各 注 
默认 情况 下 ， 编 译 所 产生 的 错误 和 和 警告 指定 包含 错误 的 文件 名 。 /fullpaths 选项 使 
编译 器 指定 文件 的 完整 路 径 。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 
请 参阅 


C# Compiler Options 


/help, /? (C£ Compiler Options) 


该 选项 将 编译 器 选项 的 列表 和 每 个 选项 的 简短 说 明 发 送 到 stdout. 


各 注 

如 果 编 译 中 包含 该 选项 ， 将 不 会 创建 输出 文件 ， 也 不 会 进行 编译 。 

此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 
请 参阅 

C£ Compiler Options 

如 何 : 修改 项 目 属性 和 配置 设置 


/Ihighentropyva (C£ Compiler Options) 


/highentropyva 编译 器 选项 告诉 Windows Atk : xe 9n 306 x f ES CREE N 
地 址 空间 格式 随机 化 (ASLR)。 


语法 


/highentropyva[-* | -] 


+|- 


此 选项 指定 一 位 64 可 执行 或 由 /platform: 了 AR nmn HJ JE EA S RES AE 
Wib i), MAEN F, GXGkcRiEIBg. (A /highentropyvat+ 或 
Ihighentropyva 中 启用 它 。 


备注 


当 随 机 化 进程 的 地 址 空间 作为 格式 ASLR 一 部 分 时 ，/highentropyva 选项 允许 
Windows ARRS ATAARE WM. FAA ARREARS 2 BiU PI e XC 
域 ( 栈 和 堆 ) , At, RENNER eR B fr BA x. 


当 指 定 /highentropyva 编译 器 选项 时 ， 可 执行 的 目标 和 它 所 依赖 的 任何 模块 在 测 
试 运行 作为 64 位 进程 时 ， 必 须 能 够 处 理 大 于 4 GB 的 指针 值 (GB)，。 


有 关 ASLR 的 更 多 信息 ， 请 参见 Mitigating Software Vulnerabilities。 


/keycontainer (C£ Compiler Options) 


指定 加 密 密 钥 容器 的 名 称 。 
语法 


/keycontainer:string 


参数 


String 

强 名 称 密 钥 容 器 的 名 称 。 

各 注 

使 用 /keycontainer 选项 时 ， 通 过 将 来 自 所 指定 容器 的 公 钥 插入 到 程序 集 清单 中 并 
且 用 私 钥 签名 最 终 程序 集 ， 编 译 器 可 创建 可 共享 的 组 件 。 生 成 密 钥 文件 ， 请 在 命 兮 
行 上 键入 sn -k file, sn -i 安装 密 钥 对 为 容器 。 


如 果 使 用 /target:module 进行 编译 ， 则 将 密 钥 文件 的 名 称 保存 在 模块 中 ， 并 在 使 用 
/addmodule 编译 程序 集 时 将 其 包含 到 该 程序 集中 。 


还 可 以 将 此 选项 指定 为 任何 Microsoft 中 间 语 言 (MSIL) 模块 的 源 代码 中 的 自 定义 特 
性 (System.Reflection.AssemblyKeyNameAttribute)。 


也 可 以 通过 /keyfile 将 加 密 信息 传递 给 编译 器 。 如 果 希 望 将 公 钥 添加 到 程序 集 清 单 
中 ， 但 将 程序 集 的 签名 延迟 到 该 程序 集 通过 测试 ， 则 请 使 用 /delaysign。 


有 关 更 多 信息 ， 请 参见 创建 和 使 用 具有 强 名 称 的 程序 集 和 延迟 为 程序 集 签 名 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 此 编译 器 选项 在 Visual Studio 开发 环境 中 不 可 用 。 
可 以 使 用 AssemblyKeyContainerName 以 编程 方式 访问 此 编译 器 选项 。 


请 参阅 


C# Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 


/keycontainer (C£ Compiler Options) 1103 


/keyfile (CZ Compiler Options) 
指定 包含 加 密 密 钥 的 文件 名 。 
语法 


/keyfile:file 


参数 

术语 定义 
file 包含 强 名 称 密 钥 的 文件 的 名 称 。 
各 注 


使 用 此 选项 时 ， 编 译 器 将 从 指定 的 文件 将 公 钥 插入 程序 集 清 单 中 ， 然 后 使 用 私 钥 对 
最 终 程 序 集 进 行 签名 。 若 要 生成 密 钥 文件 ， 请 在 命 合 行 上 键入 sn -k file, 


如 果 使 用 /target:module 进行 编译 ， 则 将 密 钥 文件 的 名 称 保存 在 模块 中 ， 并 在 使 
用 /addmodule 编译 程序 集 时 将 其 包含 到 创建 的 程序 集中 。 


也 可 以 使 用 /keycontainer 将 加 密 信息 传递 给 编译 器 。 如 果 需 要 部 分 签名 的 程序 


集 ， 则 使 用 /delaysign。 


如 果 在 相同 的 编译 中 指定 了 /keyfile 和 /keycontainer (通过 命令 行 选 项 或 自 定 义 特 
性 ) ， 编 译 器 将 首先 党 试 密 钥 容器 。 如 果 成 功 ， 则 使 用 密 钥 容器 中 的 信息 对 程序 集 
进行 签名 。 如 果 编 译 器 没有 找到 密 钥 容器 ， 则 将 党 试用 /keyfile 指定 的 文件 。 如 果 
成 功 ， 则 使 用 密 钥 文 件 中 的 信息 对 程序 集 进行 签名 ， 并 且 将 把 密 钥 信息 安装 到 密 角 
容器 中 (类似 sn -i) ， 这 样 ， 下 次 编译 时 密 钥 容器 将 是 有 效 的 。 


请 注意 ， 密 钥 文件 可 能 只 包含 公 钥 。 


有 关 更 多 信息 ， 请 参见 创建 和 使 用 具有 强 名 称 的 程序 集 和 延迟 为 程序 集 签 名 。 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选 


1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “ 签 名 ”属性 页 。 
3. 修改 “选择 强 名 称 密 钥 文 件 ” 属 性 。 
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可 以 使 用 AssemblyOriginatorKeyFile 以 编程 方式 访问 此 编译 器 选项 。 
请 参阅 


C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


/keyfile (C£ Compiler Options) 1105 


llangversion (C£ Compiler Options) 


导致 编译 器 只 接受 所 选 CH 语言 规范 中 包含 的 语法 。 
语法 


/langversion:option 


参数 


option 
以 下 为 有 效 值 : 
选项 ex 
default — 编译 器 接受 所 有 有 效 的 语言 语法 。 
ISO-1 编译 器 只 接受 ISO/IEC 23270:2003 C# 语言 规范 中 包含 的 语法 。 


ISO-2 编译 器 只 接受 ISO/IEC 23270:2006 C£ 语言 规范 中 包含 的 语法 。 此 规 
范 上 在 ISO 网 站 。 


3 编译 器 只 接受 3.0 版 本 CH 语言 规范 中 包含 的 语法 。 


备注 
C# 应 用 程序 所 引用 的 元 数据 不 受 /langversion 编译 器 选项 的 影响 。 


由 于 CH 编译 器 的 每 个 版 本 都 包含 语言 规范 的 扩展 ， 因 此 /langversion 不 提供 该 编 
译 器 早期 版 本 的 等 效 功能 。 


无 论 您 使 用 的 是 何 种 /langversion 设置 ， 都 将 使 用 当前 版 本 的 公共 语言 运行 时 来 


创建 .exe 或 .dll。 这 种 情况 的 一 个 例外 是 友 元 程序 集 和 /moduleassemblyname 
(C# Compiler Option)， 它 们 用 于 /langversion:ISO-1。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “生成 ”属性 页 。 

3. 单 击 “ 高 级 "按钮 。 


MSDN C# 编程 指南 & 参考 手册 2015 


4. 修改 “语言 版 本 ”属性 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参阅 LanguageVersion。 


请 参阅 
C£ Compiler Options 


如 何 : 修改 项 目 属性 和 配置 设置 


CH 语言 规范 


/langversion (C£ Compiler Options) 1107 


Aib (C£ Compiler Options) 


Nib 选项 指定 通过 /reference (C£ Compiler Options) 选项 引用 的 程序 集 的 位 置 。 
语法 


/lib:diri[,dir2] 


BB 
dir1 


在 当前 工作 目录 (调用 编译 器 的 目录 ) 或 公共 语言 运行 时 的 系统 目录 中 未 找到 引用 
的 程序 集 时 ， 编 译 器 将 在 其 中 进行 查找 的 目录 。 


dir2 


要 在 其 中 搜索 程序 集 引 用 的 一 个 或 多 个 附加 目录 。 用 逗号 分 隔 每 个 附加 目录 的 名 
称 ， 中 间 不 要 有 空格 。 


各 注 

编译 器 按 以 下 顺序 搜索 未 完全 限定 的 程序 集 引 用 : 

1. 当前 工作 目录 。 该 目录 为 从 其 调用 编译 器 的 目录 。 

2. 公共 语言 运行 时 系统 目录 。 

3. 由 /lib 指定 的 目录 。 

4. 由 LIB 环境 变量 指定 的 目录 。 

使 用 /reference 指定 程序 集 引 用 。 

llib 是 累加 的 ; 每 一 次 指定 的 值 都 追加 到 以 前 的 值 中 。 

另 一 种 使 用 /lib 的 方法 是 ， 将 任何 所 需 的 程序 集 复 制 到 工作 目录 中 ; 这 使 您 可 以 仅 
将 程序 集 名 称 传递 给 /reference。 然 后 可 以 从 工作 目录 中 删除 这 些 程序 集 。 由 于 程 


序 集 清单 中 未 指定 依赖 程序 集 的 路 径 ， 因 此 应 用 程序 可 以 在 目标 计算 机 上 启动 ， 然 
后 查找 并 使 用 全 局 程序 集 缓 存 中 的 程序 集 。 


编译 器 可 以 引用 程序 集 并 不 表示 公共 语言 运行 时 可 以 在 运行 时 找到 并 加 载 程序 集 。 
有 关 运 行 时 如 何 搜索 引用 的 程序 集 的 详细 信息 ， 请 参见 运行 时 如 何 定 位 程序 集 。 


ft Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 页 ”对 话 框 。 

2. 单 击 “引用 路 径 ” 属 性 页 。 

3. 修改 列表 框 的 内 容 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 ReferencePath。 


a t2.cs 以 创建 .exe 文件 。 编 译 器 将 在 工作 目录 和 驱动 器 C 上 根 目 录 中 查找 程序 
引用 。 


csc /lib:c:\ /reference:t2.dll t2.cs 


请 参阅 
C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


llink (C£ Compiler Options) 


使 编译 器 将 指定 程序 集中 的 COM 类 型 信息 提供 给 当前 正在 编译 的 项 目 使 用 。 
语法 


/link:fileList 
// -Or- 
/l:fileList 


参数 


fileList 
必 选 。 程 序 集 文件 名 的 逗号 分 隔 列 表 。 如 果 文 件 名 包含 空格 ， 则 将 该 文件 名 置 于 引 


号 中 。 
备注 


通过 /link 选项 ， 可 以 部 署 包含 戏 入 类 型 信息 的 应 用 程序 。 这 样 ， 该 应 用 程序 无 需 
引用 运行 时 程序 集 ， 就 可 以 使 用 运行 时 程序 集中 实现 族人 类 型 信息 的 类 型 。 如 果 发 
布 了 各 种 版 本 的 运行 时 程序 集 ， 则 包含 虚 和 人 类 型 信息 的 应 用 程序 可 以 使 用 各 种 版 

本 ， D lacie 有 关 示 例 ， 请 参见 演练 : RARBRERRAN KH (CHA 
Visual Basic) 。 


当 使 用 COM 互 操作 时 ， 使 用 /link :5 553 2622 7 FH, 3833 ERA, COM 类 型 ， 您 的 应 用 
程序 不 再 要 求 目 标 计算 机 上 存在 主 互 操作 程序 集 (PIA)。 Mink 选项 指示 编译 器 将 所 
引用 的 互 操作 程序 集中 的 COM 类 型 信息 诅 入 到 所 生成 的 编译 代码 中 。 该 COM X 
型 由 CLSID (GUID) 值 标识 。 因 此 ， 您 的 占用 程序 可 以 在 安装 有 CLSID 值 相 同 的 
相同 COM 类 型 的 目标 计算 机 上 和 运行。 自动 执行 Microsoft Office 的 应 用 程序 就 是 一 
个 很 好 的 示例 。 由 于 诸如 Office 之 类 的 应 用 程序 通常 在 不 同 的 版 本 中 保留 相同 的 
CLSID 值 ， 因 此 只 要 目标 计算 机 上 安装 有 .NET Framework 4 或 更 高 版 本 ， 的 应用 
人 COM 类 型 ， 并 使 用 包含 在 所 引用 COM 类 型 中 的 方法 、 
属性 或 事件 。 


llink 选项 仅 艇 入 接口 、 结 构 和 委托 。 不 支持 车 入 COM 类 。 
区 注意 


当 在 代码 中 创建 谱 入 COM 类 型 的 实例 时 ， 必 须 使 用 适当 的 接口 创建 该 实例 。 
如 果 尝 试 使 用 CoClass 创建 嵌入 COM 类 型 的 实例 ， 则 会 导致 错误 。 


若 要 在 Visual Studio 中 设置 Mink 选项 ， 请 添加 程序 集 引 用 并 将 Embed Interop 
Types 属性 设置 为 true。 Embed Interop Types 属性 的 默认 值 为 false。 


如 果 链 接 至 一 个 COM EFR (EFRA) ， 而 其 本 身 又 引用 另 一 个 COM 程序 集 
(程序 集 B) ， 则 在 符合 下 列 任 一 条 件 的 情况 下 也 必须 链接 至 程序 集 B : 


e 程序 集 A 中 的 类 型 继承 自 程序 集 B 中 的 类 型 或 实现 程序 集 B 中 的 接口 。 
。 调用 具有 程序 集 B 中 的 返回 类 型 或 参数 类 型 的 字段 、 属 性 、 事 件 或 方法 。 


与 /reference 编译 器 选项 类 似 ，/link 编译 器 选项 使 用 Csc.rsp 响应 文件 ， 该 文件 引 
用 经 常用 到 的 .NET Framework 程序 集 。 如 果 希 望 编译 器 不 要 使 用 Csc.rsp 文件 ， 
请 使 用 /noconfig 编译 器 选项 。 


Nink 的 缩写 形式 是 Ils 


eS A BRAK E 
以 下 各 节 介绍 在 嵌入 互 操作 类 型 的 应 用 程序 中 使 用 泛 型 关 型 时 所 存在 的 限制 。 


泛 型 接口 
不 能 使 用 从 互 操作 程序 集中 嵌入 的 泛 型 接口 。 这 将 在 下 面 的 示例 中 显示 。 


// The following code causes an error if ISampleInterface is an em 
ISampleInterface<SampleType> sample; 


[ET 
具有 泛 型 参 效 的 类 型 


对 于 具有 泛 型 参数 并 且 该 参数 类 型 是 从 互 操作 程序 集 伐 入 的 类 型 ， 如 果 该 类 型 来 自 
外 部 程序 集 ， 则 不 能 使 用 该 类 型 。 此 限制 不 适用 于 接口 。 例 如 ， 请 考虑 在 
Microsoft.Office.Interop.Excel 程序 集中 定义 的 Range 接口 。 如 果 库 从 
Microsoft.Office.Interop.Excel 程序 集 佬 入 互 操作 类 型 并 公开 一 个 返回 泛 型 类 型 的 方 
法 ， 该 泛 型 类 型 的 参数 类 型 为 Range 接口 ， 则 该 方法 必须 返回 一 个 泛 型 接口 ， 如 
下 面 的 代码 示例 中 所 示 。 





using System; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using Microsoft.Office.Interop.Excel; 


public class Utility 


// The following code causes an error when called by a client : 
public List<Range> GetRange1() { 


«| n 








j 


// The following code is valid for calls from a client assembly. 
public IList<Range> GetRange2() { 


在 下 面 的 示例 中 ， 客 户 端 代码 可 调用 在 不 出 错 的 情况 下 返回 List 泛 型 接口 的 方法 。 


public class Client 


public void Main() 


{ 

Utility util = new Utility(); 

// The following code causes an error. 

List<Range> rangeListi = util.GetRange1(); 

// The following code is valid. 

List<Range> rangeList2 = (List<Range>)util.GetRange2(); 
} 


下 面 的 代码 编译 源 文件 OfficeApp.cs 并 引用 COMData1.dll 和 COMData2.dll 中 的 
程序 集 来 生成 OfficeApp.exe。 


csc /link:COMDatai.dll,COMData2.dll /out:OfficeApp.exe OfficeApp.c: 
了 — Bill] 
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C# Compiler Options 

演练 : 做 入 托管 程序 集中 的 类 型 (C# 和 Visual Basic) 
/reference (C# Compiler Options) 

/noconfig (C£ Compiler Options) 

Command-ine Building With csc.exe 

互 操作 性 概述 (CH 编程 指南 ) 


link (C£ Compiler Options) 


1113 


llinkresource (CZ Compiler Options) 


在 输出 文件 中 创建 指向 .NET Framework 资源 的 链接 。 该 资源 文件 未 添加 到 输出 文 
件 中 。 这 和 与 /resource 选项 不 同 ， 后 者 会 将 资源 文件 散人 到 输出 文件 中 。 


语法 


/linkresource:filename[,identifier[,accessibility-modifier]] 


参数 


filename 

要 从 程序 集 链接 的 .NET Framework 资源 文件 。 

identifier (可 选 ) 

资源 的 逻辑 名 称 ; 用 于 加 载 资源 的 名 称 。 默 认为 文件 的 名 称 。 
accessibility-modifier (可 选 ) 


资源 的 可 访问 性 : 公共 或 私有 。 上 默认 为 公共 。 
a8 
备注 


默认 情况 下 ， 如 果 链 接 的 资源 是 用 C# 编译 器 创建 的 ， 则 链接 资源 在 程序 集中 就 是 
公共 的 。 若 要 使 这 些 资源 成 为 私有 的 ， 请 将 private 指定 为 可 访问 性 修饰 符 。 不 多 
许 使 用 public 或 private 以 外 的 其 他 修饰 符 。 


llinkresource 需要 除 /target:module 选项 之 外 的 /target 选项 之 一 。 


如 果 filename 是 由 例如 Resgen.exe 创建 或 在 开发 环境 中 创建 的 .NET Framework 
资源 文件 ， 则 可 以 通过 System.Resources 命名 空间 中 的 成 员 访 问 该 文件 。 有 关 更 
多 信息 ， 请 参见 System.Resources.ResourceManager。 对 于 所 有 其 他 资源 ， 请 使 
用 Assembly 类 中 的 GetManifestResource* 方法 在 运行 时 访问 资源 。 


在 filename 中 指定 的 文件 可 以 为 任何 格式 。 例 如 ， 您 可 能 想 将 本 机 DLL 设置 为 程 
序 集 的 一 部 分 ， 以 便 可 将 其 安装 到 全 局 程序 集 缓 存 中 ， 并 且 可 从 程序 集中 的 托管 代 
码 访问 它 。 下 面 的 第 二 个 示例 演示 如 何 执 行 此 操作 。 您 可 以 在 程序 集 链接 器 中 执行 
相同 的 操作 。 下 面 的 第 三 个 示例 演示 如 何 执行 此 操作 。 有 关 更 多 信息 ， 请 参见 
Al.exe (程序 集 链接 器 ) 和 使 用 程序 集 和 全 局 程序 集 缓存 。 


llinkres 是 /linkresource 的 缩写 形式 。 


此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 
编译 in.cs 并 链接 到 资源 文件 rf.resource : 


csc /linkresource:rf.resource in.cs 


将 A.cs 编译 为 DLL， 链 接 到 本 机 DLL N.dll， 并 将 输出 放置 在 全 局 程序 集 缓存 
(GAC) 中 。 在 此 示例 中 ，A.dll 和 N.dll 都 驻 留 在 GAC 中 。 


csc /linkresource:N.dll /t:library A.cs 
gacutil -i A.dll 


此 示例 和 前 一 个 示例 执行 的 是 同样 的 操作 ， 但 使 用 的 是 程序 集 链接 器 选项 。 


csc /t:module A.cs 
al /out:A.dll A.netmodule /link:N.dll 
gacutil -i A.dll 


请 参阅 
C£ Compiler Options 
Al.exe (程序 集 链接 器 ) 


使 用 程序 集 和 全 局 程序 集 缓存 
如 何 : 修改 项 目 属性 和 配置 设置 


[main (C£ Compiler Options) 


如 果 有 多 个 类 包含 Main 方法 ， 此 选项 指定 包含 程序 人口 点 的 类 。 
语法 


/main:class 


参数 


class 

包含 Main 方法 的 类 型 。 

备注 

如 果 编 译 包括 多 个 具有 Main 方法 的 类 型 ， 可 以 指定 哪个 类 型 包含 要 用 作 程 序 人 口 
点 的 Main 方法 。 

此 选项 用 在 编译 .exe 文件 时 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “ 应 用 程序 ”属性 页 。 
3. 修改 “和 启动 对 象 "属性 。 
若 要 以 编程 方式 设置 此 编译 器 选项 ， 请 参见 StartupObject。 
编译 t2.cs 和 t3.cs， 并 指定 将 在 Test2 中 找到 Main 方法 : 


csc t2.cs t3.cs /main:Test2 


请 


中 


阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 
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Imoduleassemblyname (C£ Compiler Option) 


指定 一 个 程序 集 ， 其 非 公 共 类 型 可 由 netmodule 访问 。 
语法 


/moduleassemblyname:assembly name 


参数 


assembly name 

程序 集 的 名 称 ，.netmodule 可 以 访问 该 程序 集 的 非 公共 类 型 。 

各 注 

应 使 用 /moduleassemblyname， 当 生成 .netmodule， 且 满足 以 下 条 件 的 位 置 : 

e netmodule 需要 具有 访问 现 有 程序 集中 非 公 共 类 型 的 权限 。 

。 知道 .netmodule 将 生成 的 程序 集 的 名 称 。 

e 现存 的 程序 集 已 经 被 授予 .netmodule 将 生成 到 的 程序 集 友 元 程序 集 访问 权限 。 
有 关 建 立 .netmodule 的 更 多 信息 ， 请 参见 /target:module (C£ Compiler Options), 
有 关 友 元 程序 集 的 更 多 信息 ， 请 参见 友 元 程序 集 (CH 和 Visual Basic) 。 

此 选项 在 开发 环境 中 不 可 用 ; 它 仅 在 从 命令 行 编 译 时 才 可 用 。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 


此 示例 生成 具有 私有 类 型 的 程序 集 ， 并 且 该 程序 集 授 予 称 为 csman_an_assembly 
的 程序 集 友 元 程序 集 访 问 权 限 。 


// moduleassemblyname 1.cs 

// compile with: /target:library 

using System; 

using System.Runtime.CompilerServices; 
[assembly:InternalsVisibleTo ("csman an assembly")] 
class An Internal Class 


public void Test() 
{ 


} 


Console.WriteLine("An_Internal_Class.Test called"); 


该 例 建立 一 个 可 访问 程序 集 moduleassemblyname_1.dll 中 非 公共 类 型 

的 .netmodule。 通 过 了 解 此 .netmodule 将 生成 到 调用 csman_an_assembly 的 程序 
集 ， 可 以 指定 /moduleassemblyname， 人 允许 .netmodule 在 已 经 别 授予 
csman_an_assembly 的 友 元 程序 集 访问 权限 的 程序 集中 访问 非 公共 类 型 。 


// moduleassemblyname 2.cs 
// compile with: /moduleassemblyname:csman an assembly /target:modt 
class B ( 
public void Test() ( 
An Internal Class x - new An Internal Class(); 
x.Test(); 


4 = S 


此 代码 示例 通过 引用 以 前 生成 的 程序 集 和 .netmodule ， 生 成 程序 集 
csman_an_assembly。 





// csman an assembly.cs 
// compile with: /addmodule:moduleassemblyname 2.netmodule /referer 
class A { 
public static void Main() { 
B bb = new B(); 
bb.Test(); 





已 调用 An Internal Class.Test 
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请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


/moduleassemblyname (C£ Compiler Option) 1120 


Inoconfig (C# Compiler Options) 


Inoconfig 选项 通知 编译 器 不 要 使 用 csc.rsp 文件 进行 编译 ， 该 文件 与 csc.exe X 
件 位 于 同一 目录 中 ， 并 从 该 目录 中 加 载 。 


语法 


/noconfig 


各 注 
csc.rsp 文件 引用 .NET Framework 附带 的 所 有 程序 集 。Visual Studio .NET 开发 环 
境 包 括 的 实际 引用 具体 取决 于 项 目 类 型 。 


可 以 修改 csc.rsp 文件 并 指定 其 他 编译 器 选项 ， 而 这 些 选项 是 那些 应 该 包括 在 使 用 
csc.exe 的 来 自命 令 行 的 每 次 编译 中 的 选项 (noconfig 选项 除外 ) 。 


编译 器 会 保留 上 次 传递 给 csc 命令 的 选项 。 因 此 ， 命 令 行 上 的 任何 选项 都 会 重 写 
csc.rsp 文件 中 同一 选项 的 设置 。 


如 果 不 希望 编译 器 查找 并 使 用 csc.rsp 文件 中 的 设置 ， 请 指定 /noconfig。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 


请 参阅 


C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Inologo (C£ Compiler Options) 


Mir E 选项 在 编译 器 启动 时 取消 显示 登录 版 权 标志 ， 并 在 编译 期 间 取 消 显示 信息 


语法 
/nologo 
各 注 


此 选项 在 开发 环境 中 不 可 用 ; 它 久 在 从 命令 行 编译 时 才 可 用 。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 


请 参阅 


C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Inostdlib (C£ Compiler Options) 


Inostdlib 禁止 导入 定义 整个 System 命名 空间 的 mscorlib.dll。 
语法 


/nostdlib[+ | -] 


备注 
如 果 您 希望 定义 或 创建 自己 的 System 命名 空间 和 对 象 ， 请 使 用 该 选项 。 


如 果 不 指定 nostdlib, mscorlib.dll 将 导入 程序 (与 指定 /nostdlib- 相同 ) 。 指 定 
/nostdlib 与 指定 /nostdlib+ 的 作用 相同 。 


ft Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “生成 ”属性 页 。 

3. 单 击 “ 高 级 ”按钮 。 

4. 修改 “不 引用 mscorlib.dll” 属 性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 NoStdLib。 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Inowarn (C£ Compiler Options) 


Inowarn 选项 允许 您 禁止 编译 器 显示 一 个 或 多 个 警告 。 用 逗号 分 隔 多 个 警告 编号 。 
BiB 

/nowarn:number1[,number2,... ] 
参数 


number1, number2 


您 希望 编译 器 取消 的 警告 编号 
备注 
只 应 指定 警告 标识 符 的 数值 部 分 。 例 如 ， 若 要 取消 CS0028， 可 以 指定 


/nowarn:28。 


编译 器 在 无 人 参与 的 模式 下 忽略 传递 给 Inowarn 的 警告 编号 ， 这 些 和 警告 编号 在 先前 
版 本 中 有 效 但 已 从 编译 器 中 移 除 。 例 如 ，CS0679 在 Visual Studio .NET 2002 中 有 
效 但 后 来 被 删除 。 


/nowarn 选项 无 法 禁止 显示 以 下 警告 
e 编译 器 警告 (等 级 1) CS2002 
e 编译 器 警告 (Fw 1) CS2023 
e 编译 器 警告 (等 级 1) CS2029 


nd 


ne 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 

1. 打开 项 目的 “属性 ”页 。 有 关 详 细 信 息 ， 请 人 参见“ 项目 设计 器 "->“ 生 成 "页 (C#)。 
2. 单 击 “ 生 成 ”属性 页 。 

3. 修改 “取消 警告 ”属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参阅 DelaySign。 


青 参 阅 
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C# Compiler Options 
如 何 : 修改 项 目 属 性 和 配置 设置 
C£ Compiler Errors 


/nowarn (C£ Compiler Options) 1125 


Inowin32manifest (C£ Compiler Options) 


使 用 Inowin32manifest :& 7 RT TRZR 48 13 38 MHE 7 FH f FE 28 BRA I RT AIT 
件 中 。 


语法 


/nowin32manifest 


备注 


使 用 此 选项 时 ， 除 非 在 Win32 资源 文件 或 以 后 的 生成 步骤 中 提供 应 用 程序 清单 ， 否 
则 应 用 程序 会 受到 Windows Vista 上 虚拟 化 的 影响 。 有 关 虚 拟 化 的 更 多 信息 ， 请 参 
见 。80efa4c7-3904-45c5-82e8-2d558fe67db9 


f£ Visual Studio 的 “点 用 程序 属性 ”页 中 ， 通 过 在 “ 清 妆 u p Dd "n 
清单 的 应 用 程序 ”选项 来 设置 此 选项 。 有 关 更 多 信息 ， 请 参 Rh Bikit BR” -> “应 用 
程序 "页 (CH). 


有 关 创 建 清单 的 更 多 信息 ， 请 参见 /win32manifest (C# Compiler Options). 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


loptimize (C£ Compiler Options) 


loptimize 选项 启用 或 禁用 由 编译 器 执行 以 使 输出 文件 更 小 、 更 快 和 更 有 效 的 优 
化 。 


语法 


/optimize[+ | -] 


备注 

loptimize 选项 还 通知 公共 语言 运行 时 在 运行 时 优化 代码 。 

默认 情况 下 ， 将 禁用 优化 。 指 定 /optimize+ 以 启用 优化 。 

在 生成 要 由 程序 集 使 用 的 模块 时 ， 请 使 用 与 该 程序 集 的 设置 相同 的 /optimize ix 


[Bo 
lo 是 /optimize 的 缩写 形式 。 
可 以 组 合 /optimize 和 /debug 选项 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “生成 ”属性 页 。 

3. 修改 “优化 代码 ”属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 Optimize。 
生成 世 .cs 并 人 允许 编译 器 优化 : 


csc t2.cs /optimize 


请 


" 


阅 


C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


lout (C£ Compiler Options) 


lout 选项 指定 输出 文件 的 名 称 。 


/out:filename 


参数 


filename 

由 编译 器 创建 的 输出 文件 的 名 称 。 

各 注 

在 命令 行 中 ， 可 以 为 编译 指定 多 个 输出 文件 。 编 译 器 希望 在 /out 选项 之 后 找到 一 个 
或 多 个 源 代码 文件 。 这 样 一 来 ， 所 有 的 源 代 码 文 件 都 将 被 编译 到 /out 选项 所 指定 的 
那个 输出 文件 中 。 

指定 要 创建 的 文件 的 完整 名 称 和 扩展 名 。 

如 果 不 指定 输出 文件 的 名 称 : 

e exe 文件 将 从 包含 Main 方法 的 源 代 码 文件 中 获取 其 名 称 。 

e 一 个 .dl 或 者 netmodule 将 从 第 一 个 源 代码 文件 中 获取 其 名 称 。 


用 于 编译 一 个 输出 文件 的 源 代码 文件 不 能 在 相同 的 编译 中 用 作 另 一 个 输出 文件 的 编 
译 。 

当 在 命令 行 编译 中 产生 多 个 输出 文件 时 ， 请 记 住 其 中 只 有 一 个 输出 文件 可 以 是 程序 
集 并 且 只 有 用 /out 隐 式 或 显 式 指定 的 第 一 个 输出 文件 才 是 程序 集 。 


作为 编译 的 一 部 分 产生 的 任何 模块 都 变 成 与 编译 中 产生 的 所 有 程序 集 相 关 的 文件 。 
使 用 ildasm.exe 浏览 程序 集 清单 以 查看 相关 的 文件 。 


为 使 EXE 成 为 友 元 程序 集 的 目标 ， 需 要 /out 编译 器 选项 。 有 关 更 多 信息 ， 请 参见 
友 元 程序 集 (C# 和 Visual Basic) 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 


2. 单 击 “应 用 程序 ”属性 页 。 
3. 修改 “程序 集 名 称 ” 属 性 。 


若 要 以 编程 方式 设置 此 编译 器 选项 : OutputFileName 是 只 读 属 性 ， 它 由 项 目 
类 型 (exe. F) 和 程序 集 名 称 的 组 合 确定 。 必 须 修 改 这 两 个 属性 中 的 一 个 
或 全 部 才能 设置 输出 文件 名 。 


编译 t.cs 并 创建 输出 文件 texe， 同 时 又 生成 t2.cs 并 创建 模块 输出 文件 


mymodule.netmodule : 


csc t.cs /out:mymodule.netmodule /target:module t2.cs 


请 


中 


阅 
C£ Compiler Options 


友 元 程序 集 (C# 和 Visual Basic) 
如 何 : 修改 项 目 属 性 和 配置 设置 


/pdb (C£ Compiler Options) 


/pdb 编译 器 选项 指定 调试 符号 文件 的 名 称 和 位 置 。 
语法 


/pdb:filename 


参数 


filename 


调试 符号 文件 的 名 称 和 位 置 。 

各 注 

当 您 指定 /debug (C£ Compiler Options) 时 ， 编 译 器 将 在 创建 输出 文件 (exe 或 
dil) 的 同一 目录 下 创建 一 个 与 输出 文件 同名 的 .pdb 文件 。 

/pdb 人 允许 您 为 .pdb 文件 指定 非 默 认 的 文件 名 和 位 置 。 


不 能 在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 ， 也 不 能 以 编程 方式 对 其 进行 更 
改 。 


编译 t.cs 并 创建 一 个 名 为 tt.pdb 的 .pdb 文件 : 


csc /debug /pdb:tt t.cs 


请 参阅 
C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


Iplatform (CZ Compiler Options) 


指定 公共 语言 运行 时 (CLR) 的 哪个 版 本 可 以 运行 程序 集 。 


/platform:string 


参数 


String 


anycpu( 默 认 值 )，anycpu32bitpreferred，ARM，x64，x86、 或 者 ltanium。 


备注 


e anycpu (默认 值 ) 将 编译 程序 集 为 使 其 在 任意 平台 上 都 可 以 运行 。 在 任何 可 
能 的 时 候 ， 应 用 程序 作为 64 位 进程 运行 ; 仅 当 该 模式 只 可 用 时 ， 才 会 回 退 到 
32 位 。 


e anycpu32bitpreferred 将 程序 集 编译 成 可 在 任何 平台 上 运行 。 上 应 用 程序 在 支 
持 64 位 和 32 位 应 用 程序 的 系统 以 32 位 模式 运行 。 可 以 仅仅 为 针对 .NET 
Framework 4.5 的 项 目 指定 此 选项 。 


ARM 编 译 程序 集 ， 以 便 可 以 在 具有 高 级 RISC (ARM) 计算 机 处 理 器 的 计算 机 运 
{To 
x64 将 程序 集 编译 成 可 由 64 位 公共 语言 运行 库 在 支持 AMD64 或 EM64T 指令 
集 的 计算 机 上 运行 。 
X86 将 程序 集 编译 为 由 与 x86 兼容 的 32 位 公共 语言 运行 时 运行 。 
ltanium 将 程序 集 编译 为 由 采用 Itanium 处理 器 的 计算 机 上 的 64 位 公 
行 时 运行 。 
在 64 位 Windows 操作 系统 上 : 
e 用 /platform:x86 编译 的 程序 集 将 在 运行 于 WOW64 下 的 32 位 CLR 上 执行 。 
e 用 /platform:anycpu 编译 的 DLL 将 在 加 载 该 进程 的 同一 CLR 上 执行 。 
e 用 /platform:anycpu 编译 的 可 执行 文件 将 在 64 位 CLR 上 执行 。 


e 
is 
B 


e 用 /platform:anycpu32bitpreferred 编译 的 可 执行 文件 将 在 32 位 CLR 上 执 
行 。 


anycpu32bitpreferred 设置 只 对 为 可 执行 (.exe) 文件 有 效 ， 因 此 ， 它 需要 .NET 
Framework 4.5。 


有 关 开 发 在 Windows 64 位 操作 系统 上 运行 的 应 用 程序 的 更 多 信息 ， 请 参见 64 位 
应 用 程序 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “生成 ”属性 页 。 


3. 修改 目标 平台 属性 ， 因 此 ， 若 要 面向 .NET Framework 4.5， 选 择 或 清除 首选 
32 位 复 选 框 。 


Note /platform 在 Visual C# 速成 版 开发 环境 中 不 可 用 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 PlatformTarget。 

下 面 的 示例 演示 如 何 使 用 /platform 选 项 来 指定 应 只 由 64 位 Windows 操作 系统 上 
的 64 位 CLR 运行 的 应 用 程序 。 


csc /platform:anycpu filename.cs 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


/preferreduilang (CZ Compiler Options) 


使 用 Ipreferreduilang 编译 器 选项 ， 则 可 指定 C# 编 译 器 显示 输出 的 语言 ， 如 错误 


消息 。 
‘ne 
语法 


/preferreduilang: language 


参数 


language 


编译 器 输出 用 到 的 语言 的 语言 名 称 。 
各 注 


可 以 使 用 /preferreduilang 编译 器 选项 指定 C# 编译 器 用 于 错误 消息 和 其 他 命令 行 
输出 的 语言 。 如 果 语 言 的 语言 包 不 安装 ， 使 用 操作 系统 的 语言 设置 ， 因 此 ， 不 会 报 


告 错误 。 


csc.exe /preferreduilang:ja-JP 


请 参阅 


C# Compiler Options 


/recurse (C£ Compiler Options) 


/recurse 选项 使 您 可 以 编译 指定 目录 (dir) 或 项 目 目录 的 所 有 子 目 录 中 的 源 代码 文 
件 。 


语法 


/recurse:[dirN]file 


参数 


dir (可 选 ) 

搜索 开始 的 目录 。 如 果 未 指定 此 目录 ， 则 搜索 从 项 目 目录 开始 。 
file 

要 搜索 的 文件 。 人 允许 使 用 通配符 字符 。 


各 注 
/recurse 选项 使 您 可 以 编译 指定 目录 (dir) 或 项 目 目录 的 所 有 子 目录 中 的 源 代码 文 
件 。 


可 以 在 文件 名 中 使 用 通配符 来 编译 项 目 目录 中 所 有 匹配 的 文件 ， 而 不 需 使 用 


/recurse。 
此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 
编译 当前 目录 中 的 所 有 C# 文件 : 


CSC CS 


编译 dir1\dir2 目录 及 其 任何 子 目 录 中 的 所 有 CH 文件 ， 并 生成 dir2.dll : 


csc /target:library /out:dir2.dll /recurse:diriNdir2N*.cs 


请 参阅 


C£ Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 
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Ireference (C£ Compiler Options) 


lreference 选项 导致 编译 器 将 指定 文件 中 的 公开 类 型 信息 导入 到 当前 项 目 中 ， 从 
而 使 您 可 以 从 指定 的 程序 集 文件 引用 元 数据 。 


语法 


/reference:[alias-]filename 
/reference:filename 


参数 


filename 


包含 程序 集 清单 的 文件 的 名 称 。 若 要 导入 多 个 文件 ， 请 为 每 个 文件 包括 一 个 单独 的 


/reference 选项 。 
alias 
一 个 有 效 的 CH 标识 符 ， 表 示 将 包含 程序 集中 所 有 命名 空间 的 根 命 名 空间 。 


各 注 
若 要 从 多 个 文件 导入 ， 请 为 每 个 文件 包括 一 个 /reference 选项 。 


导入 的 文件 必须 包含 一 个 清单 ; 输出 文件 必须 已 使 用 /目标 :模块 以 外 的 /目标 选项 
之 一 编译 过 。 


Ir 是 /reference 的 缩写 形式 。 
使 用 /addmodule 从 不 包含 程序 集 清单 的 输出 文件 导入 元 数据 。 


如 果 您 引用 了 一 个 程序 集 (程序 集 A) ， 其 本 身 又 引用 了 另 一 个 程序 集 (程序 集 
B) ， 则 在 下 列 情况 下 需要 引用 程序 集 B : 


e 使 用 来 自 程序 集 A 的 类 型 继承 自 程序 集 B 中 的 类 型 或 实现 程序 集 B 中 的 接 


。 调用 具有 程序 集 B 中 的 返回 类 型 或 参数 类 型 的 字段 、 属 性 、 事 件 或 方法 。 


使 用 /lib 指定 一 个 或 多 个 程序 集 引 用 所 在 的 目录 。 /lib 主题 还 讨论 了 编译 器 在 哪些 
目录 中 搜索 程序 集 。 


为 使 编译 器 可 以 识别 程序 集 (而 不 是 模块 ) 中 的 某 个 类 型 ， 需 要 强制 解析 此 类 型 ， 

这 可 以 通过 定义 此 类 型 的 实例 来 完成 。 还 有 其 他 方法 可 为 编译 器 解析 程序 集中 的 类 
型 名 称 : 例如 ， 如 果 您 从 程序 集中 的 类 型 继承 ， 编 译 器 就 能 识别 类 型 名 称 。 

有 时 必须 从 一 个 程序 集 内 部 引用 同一 组 件 的 两 个 不 同 版 本 。 为 此 ， 请 在 每 个 文件 的 
/reference 开关 上 使 用 alias 子 选 项 ， 以 区 分 两 个 文件 。 此 别名 将 用 作 组 件 名 称 的 
限定 符 ， 并 解析 为 其 中 一 个 文件 中 的 组 件 。 


默认 情况 下 使 用 csc 响应 (rsp) 文件 ， 该 文件 引用 常用 的 .NET Framework 程序 
集 。 如 果 希 望 编译 器 不 要 使 用 csc.rsp， 请 使 用 /noconfig。 


jo = 
Eg TERR 


f£ Visual Studio 中 ， 请 使 用 “添加 引用 ”对 话 框 。 有 关 更 多 信息 ， 请 参见 如 何 : 
使 用 “添加 引用 ”对 话 框 添加 或 移 除 引用 。 在 Visual Studio 2010 和 更 高 版 本 中 ， 
若 要 确保 通过 使 用 reference 添加 引用 与 通过 使 用 “添加 引用 ”对 话 框 添加 引用 
之 间 的 行为 等 效 ， 必 须 将 您 要 添加 的 程序 集 的 “ 拷 入 互 操 作 类 型 ”属性 设置 

为 “False”。“True” 为 该 属性 的 默认 值 。 


示例 

本 示例 演示 如 何 使 用 外 部 别名 功能 。 

编译 源 文件 ， 并 从 先前 已 编译 的 grid.dll 和 grid20.dll 中 导入 元 数据 。 这 两 个 DLL 

包含 同一 组 件 的 不 同 版 本 ， 您 将 使 用 两 个 带 有 别名 选项 的 reference 编译 源 文件 。 

这 两 个 选项 如 下 所 示 : 

/reference:GridV1=grid.dll 和 /reference:GridV2=grid20.dll 

这 将 设置 外 部 别名 “GridV1” 和 “GridV2”， 您 将 在 程序 中 通过 外 部 语句 使 用 它们 : 
extern alias GridV1; 


extern alias GridV2; 
// Using statements go here. 


完成 此 操作 后 ， 您 可 以 通过 在 控件 名 称 前 添加 GridV1 前 级 来 引用 grid.dll 中 的 网 格 
控件 ， 如 下 所 示 : 


GridV1::Grid 


此 外 ， 您 可 以 通过 在 控件 名 称 前 添加 GridV2 前 级 来 引用 grid20.dll 中 的 网 格 控件 ， 
如 下 所 示 : 


GridV2::Grid 


MSDN C# 编程 指南 & 参考 手册 2015 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 
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/resource (C# Compiler Options) 


将 指 定 的 资源 嵌入 到 输出 文件 中 。 
语法 


/resource:filename[,identifier[,accessibility-modifier]] 


参数 


filename 

fete Hoc fee AY .NET Framework 资源 文件 。 

identifier (可 选 ) 

资源 的 逻辑 名 称 ; 用 于 加 载 资源 的 名 称 。 黑 认为 文件 的 名 称 。 
accessibility-modifier (可 选 ) 

资源 的 可 访问 性 : 公共 或 私有 。 默 认为 公共 。 

各 注 

使 用 /linkresource 将 资源 链接 到 程序 集 ， 但 不 将 资源 文件 添加 到 输出 文件 中 。 
默认 情况 下 ， 如 果 资 源 是 用 CH 编译 器 创建 的 ， 则 该 资源 在 程序 集中 就 是 公共 的 。 
若 要 使 这 些 资源 成 为 私有 的 ， 请 将 private 指定 为 可 访问 性 修饰 符 。 不 允许 使 用 
public 或 private 以 外 的 可 访问 性 。 

如 果 filename 是 由 例如 Resgen.exe 创建 或 在 开发 环境 中 创建 的 .NET Framework 
资源 文件 ， 则 可 以 通过 System.Resources 命名 空间 中 的 成 员 访 问 该 文件 。 有 关 更 
多 信息 ， 请 参见 System.Resources.ResourceManager。 对 于 所 有 其 他 资源 ， 请 使 
用 Assembly 类 中 的 GetManifestResource* 方法 在 运行 时 访问 资源 。 

TEX. 

资源 在 输出 文件 中 的 顺序 是 由 命令 行 上 指定 的 顺序 决定 的 。 


/res 是 /resource 的 缩 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 将 资源 文件 添加 到 项 目 中 。 


2. FEAR RDS AIRS, ARRANA. 


3. 在 “属性 ”窗口 中 ， 为 该 文件 选择 “生成 操作 ”。 
4. 将 “生成 操作 ”设置 为 “ 褒 入 的 资源 ”。 


有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 


编译 in.cs 并 附加 资源 文件 rf.resource : 


csc /resource:rf.resource in.cs 


请 


" 


阅 


C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


BuildAction, 


Isubsystemversion (CZ Compiler Options) 


指定 产生 的 可 执行 文件 可 以 运行 的 子 系统 的 最 低 版 本 ， 从 而 确定 执行 文件 可 以 运行 
的 Windows 的 版 本 。 通 常 ， 此 选项 确保 可 执行 文件 可 以 利用 Windows 早 期 版 本 中 不 
可 以 使 用 的 特定 安全 功能 。 

8 注意 


若 要 指定 的 子 系统 ， 请 使 用 target 编译 器 选项 。 
语法 


/subsystemversion:major.minor 


参数 
major.minor 


子 系 统 的 最 低 要 求 的 版 本 ， 主 要 和 次 要 版 本 的 点 表示 形式 表示 。 例 如 ， 可 以 指定 一 
个 不 可 以 运行 在 Windows 7 以 前 的 操作 系统 的 应 用 程序 ， 如 本 主题 后 面 的 表 所 述 ， 
如 果 将 此 选项 值 设 置 为 6.01。 必 须 为 major 和 minor 指定 值 为 整数 。 


前 导 需 的 minor 版 本 不 更 改版 本 ， 但 是 填充 的 需 更 改 。 例 如 ，6.1 和 6.01 都 引用 同 
一 个 版 本 ， 但 是 ，6.10 引用 不 同 版 本 的 。 建 议 把 次 版 本 表示 为 两 个 数字 以 避免 混 
Bo 

备注 


下 表 列 出 常用 Windows 子 系统 版 本 。 


Windows 版 本 
Windows 2000 
Windows XP 
Windows Server 2003 
Windows Vista 
Windows 7 
Windows Server 2008 
Windows 8 


默认 值 


5.00 
5101 
5.02 
6.00 
6.01 
6.01 
6.02 


子 系统 版 本 


Isubsystemversion 编译 器 选项 的 默认 值 取 决 于 列表 下 面 的 条 件 : 
e 如 果 以 下 列表 中 的 任何 编译 器 选项 被 设置 ， 默 认 值 为 6.02: 


o /target:appcontainerexe 
o /target:winmdobj 


o /platform:arm 


e 如 果 使 用 MSBuild， 默 认 值 为 6.00， 则 以 .NET Framework 4.54 8A), #8 


未 设置 此 列表 之 前 指定 的 任何 编译 器 选项 。 
e 如 果 以 上 条 件 都 不 符合 ， 默 认 值 为 4.00。 


设置 此 选项 


BEE Visual Studio 中 设置 /subsystemversion 编译 器 选项 ， 则 必须 在 MSBuild 
XML 中 打开 .csproj 文件 和 指定 SubsystemVersion 属性 值 。 您 不 能 在 Visual 
Studio IDE 中 设置 此 选项 。 有 关 详 细 信 息 ， 请 参阅 本 主题 前 面 的 “默认 值 "或 常用 的 


MSBuild 项 目 属性 。 


请 参阅 
C# Compiler Options 
MSBuild 属性 


[target (C£ Compiler Options) 


target 编译 器 选项 可 以 指定 为 以 下 四 种 形式 之 一 : 
/target:appcontainerexe 

创建 Windows 8.x 应 用 商店 应 用 的 .exe 文件 。 
/target:exe 

创建 .exe 文件 。 

/target:library 

创建 代码 库 。 

/target:module 

创建 模块 。 

/target:winexe 

创建 Windows 程序 。 

/target:winmdobj 

创建 一 个 .winmdobj FP jg X fF, 


如 果 不 指定 /target:module, /target 244% .NET Framework 程序 集 清 单 放 入 输出 
文件 中 。 有 关 更 多 信息 ， 请 参见 公共 语言 运行 时 中 的 程序 集 和 公共 特性 。 


程序 集 清单 放置 在 编译 中 的 第 一 个 .exe 输出 文件 中 ， 如 果 没 有 .exe 输出 文件 ， 会 
放置 在 第 一 个 DLL 中 。 例 如 ， 在 以 下 的 命令 行 中 ， 清 单 将 放置 在 1.exe 中 : 


csc /out:1.exe ti.cs /out:2.netmodule t2.cs 


编译 器 每 次 编译 只 创建 一 个 程序 集 清单 。 关 于 编译 中 所 有 文件 的 信息 全 放 在 程序 集 
清单 中 。 除 用 /target:module 创建 的 文件 之 外 ， 所 有 输出 文件 都 可 以 包含 程序 集 
清单 。 在 命令 行 生成 多 个 输出 文件 时 ， 只 能 创建 一 个 程序 集 清 单 ， 且 必须 放置 在 命 
倒 行 上 指定 的 第 一 个 输出 文件 中 。 无 论 第 一 个 输出 文件 是 什么 
(/target:exe、/target:winexe、/target:library 或 /target:module) ， 在 同一 编 
译 中 生成 的 任何 其 他 输出 文件 都 必须 是 模块 (ltarget:module)。 


如 果 创 建 了 一 个 程序 集 ， 则 可 以 用 CLSCompliantAttribute 特性 指示 全 部 或 部 分 代 
码 是 符合 CLS 的 。 


// target clscompliant.cs 
[assembly:System.CLSCompliant(true)] // specify assembly compliar 


[System.CLSCompliant(false)] // specify compliance for an element 
public class TestClass 


( 


j 
a — 


有 关 以 编程 方式 设置 此 编译 器 选项 的 更 多 信息 ， 请 参见 OutputType。 


public static void Main() { 








请 参阅 
C£ Compiler Options 


如 何 : 修改 项 目 属性 和 配置 设置 


/Subsystemversion (C£ Compiler Options) 


Itarget:appcontainerexe (C# 编译 器 选项 ) 


如 果 使 用 /target:appcontainerexe 编译 器 选项 ， 则 编译 器 会 创建 一 个 必须 在 应 用 
容器 中 运行 的 Windows 可 执行 (.exe) 文件 。 此 选项 与 /targetwinexe 等 效 ， 但 专 
门 用 于 Windows 8.x 应 用 商店 应 用 。 


语法 


/target:appcontainerexe 


备注 


为 了 要 求 应 用 在 应 用 容器 中 运行 ， 此 选项 在 可 移植 可 执行 (PE) 文件 中 设置 了 一 
位 。 设 置 该 位 时 ， 如 果 CreateProcess 方法 尝试 在 应 用 容器 外 启动 该 可 执行 文件 ， 
就 会 BH Iko 


除非 使 用 /out 选项 ， 否 则 输出 文件 名 采用 包含 Main 方法 的 输入 文件 的 名 称 。 


如 果 在 命 合 提 示 符 处 指定 此 选项 ， 则 在 下 一 个 /out 或 /target 选项 之 前 ， 会 使 用 所 
有 文件 来 创建 可 执行 文件 。 


在 IDE 中 设置 此 编译 器 选项 


1. 在 “解决 方案 资源 管理 器 "中 ， 打 开 项 目的 快捷 菜单 ， 然 后 选择 “属性 ”。 


2. 在 “应 用 程序 ”选项 卡 上 ， 在 “输出 类 型 ”列表 中 选择 “Windows 应 用 商店 应 
用 ”。 
此 选项 仅 可 用 于 Windows 8.x 应 用 商店 应 用 模板 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参阅 OutputType。 
以 下 命令 将 filename.cs 编译 为 一 个 只 能 在 应 用 容器 中 运行 的 Windows 可 执行 文 
件 。 


csc /target:appcontainerexe filename.cs 


请 


" 


阅 


/target (C£ Compiler Options) 
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/target:winexe (C£ Compiler Options) 
C£ Compiler Options 


/target:appcontainerexe (CX 编译 器 选项 ) 1146 


Itarget:exe (CZ Compiler Options) 


Itarget:exe 选项 使 编译 器 创建 可 执行 (EXE) 的 控制 台 应 用 程序 。 
语法 


/target:exe 


各 注 

默认 情况 下 ，/target:exe 选项 有 效 。 将 创建 带 扩展 名 .exe 的 可 执行 文件 。 

使 用 /target:winexe 创建 可 执行 的 Windows 程序 。 

除非 另外 使 用 /out 选项 指定 ， 否 则 输出 文件 名 采用 包含 Main 方法 的 输入 文件 名 。 


在 命令 行 上 指定 该 选项 时 ， 下 一 个 /out 或 /target:module 选项 之 前 的 所 有 文件 都 
将 用 于 创建 .exe 文件 


在 编译 到 exe 文件 中 的 源 代码 文件 中 要 求 有 且 仅 有 一 个 main 方法 。 /main 编译 器 
选项 使 您 可 以 在 代码 中 包含 多 个 具有 main 方法 的 类 的 情况 下 ， 指 定 包 含 main 方 
法 的 类 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 应 用 程序 ”属性 页 。 

3. 修改 “输出 类 型 "属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 OutputType。 


下 列 每 个 命令 行 都 编译 in.cs， 创 建 in.exe : 


csc /target:exe in.cs 
csc in.cs 


请 参阅 


/target (C# Compiler Options) 
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/target:exe (C£ Compiler Options) 1148 


Itarget:library (C£ Compiler Options) 


Itarget:library 选项 使 编译 器 创建 一 个 动态 链接 库 (DLL) 而 不 是 一 个 可 执行 文件 
(EXE)。 


语法 


/target:library 


各 注 
DLL 创建 后 会 带 有 .dll 扩展 名 。 
除非 使 用 /out 选项 另外 指定 ， 否 则 输出 文件 的 名 称 采用 第 一 个 输入 文件 的 名 称 。 


在 命令 行 上 指定 该 选项 时 ， 下 一 个 /out 或 /target:module 选项 之 前 的 所 有 文件 都 
将 用 于 创建 .dll 文件 。 


生成 .dll 文件 时 ， 不 需要 main 方法 。 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 应 用 程序 ”属性 页 。 

3. 修改 “输出 类 型 "属性 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 OutputType。 
编译 in.cs， 创 建 in.dll : 


csc /target:library in.cs 


请 


" 


阅 
/target (C£ Compiler Options) 
C£ Compiler Options 


Itarget:module (C£ Compiler Options) 


此 选项 导致 编译 器 不 会 生成 程序 集 清单 。 
语法 


/target:module 


各 注 
默认 情况 下 ， 使 用 此 选项 编译 时 所 创建 的 输出 文件 具有 .netmodule 扩 展 名 。 


没有 程序 集 清 单 的 文件 无 法 由 .NET Framework 公共 语言 运行 时 加 载 。 但 可 以 通过 
/addmodule 将 这 类 文件 并 入 程序 集 清单 中 。 


如 果 在 一 次 编译 中 创建 了 多 个 模块 ， 一 个 模块 中 的 internal 类 型 可 用 于 此 编译 中 的 
其 他 模块 。 如 果 一 个 模块 中 的 代码 引用 另 一 个 模块 中 的 internal 类 型 ， 则 两 个 模块 
都 必须 通过 laddmodule 合并 到 一 个 程序 集 清单 中 。 


Visual Studio 开发 环境 不 支持 创建 模块 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 OutputType。 


编译 in.cs， 创 建 in.netmodule : 


csc /target:module in.cs 


请 


中 


阅 


/target (C£ Compiler Options) 
C£ Compiler Options 


Itarget:winexe (C# Compiler Options) 


Itarget:winexe 选项 使 编译 器 创建 可 执行 (EXE) 的 Windows 程序 。 
语法 


/target :winexe 


备注 

将 创建 带 扩 展 名 .exe 的 可 执行 文件 。Windows 程序 是 一 种 由 .NET Framework È 
或 使 用 Win32 API 提供 一 个 用 户 界 面 的 程序 。 

使 用 /targetexe 创建 控制 台 应 用 程序 。 

除非 另外 使 用 /out 选项 指定 ， 否 则 输出 文件 名 采用 包含 Main 方法 的 输入 文件 名 。 


在 命令 行 指定 该 选项 时 ， 直 至 下 一 个 out 或 /target 选项 之 前 的 所 有 文件 都 将 用 于 
创建 Windows 程序 。 

在 编译 到 .exe 文件 中 的 源 代 码 文 件 中 要 求 有 且 公 有 一 个 main 方法 。 /main 选项 使 
您 可 以 在 代码 中 包含 多 个 具有 main 方法 的 类 的 情况 下 ， 指 定 包含 main 方法 的 


米 
Fo 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 应 用 程序 ”属性 页 。 

3. 修改 “输出 类 型 ”属性 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 OutputType。 
将 in.cs 编译 成 Windows 程序 : 


csc /target:winexe in.cs 


请 参阅 


/target (C# Compiler Options) 
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Itarget:winmdobj (CZ 编译 器 选项 ) 


如 果 使 用 /target:winmdobj 编译 器 选项 ， 则 编译 器 会 创建 一 个 中 间 .winmdobj X 
件 ， 您 可 以 将 这 个 文件 转换 为 Windows 运行 时 二 进 制 (.winmd) 文件 。 之 后 ， 除 了 
托管 语言 程序 外 ，JavaScript 和 C++ 程序 也 可 以 使 用 该 .winmd 文件 。 


语法 


/target :winmdobj 


备注 


winmdobj 设置 会 向 编译 器 发 出 信号 ， 表 示 需 要 中 间 模 块 。 作 为 响应 ，Visual 
Studio &ft CH 类 库 编 译 为 .winmdobj 文件 。 随 后 ，.winmdobj 文件 可 作为 可 作为 
WinMDExp 导出 工具 的 输入 ， 生 成 Windows 元 数据 (.winmd) 文件 。.winmd 文件 
既 包 含 原始 库 的 代码 ， 也 包括 JavaScript (或 C++) 以 及 Windows 运行 时 使 用 的 
WinMD 元 数据 的 代码 。 


使 用 Itarget:winmdobj 编译 器 选项 所 编译 的 文件 ， 只 能 用 作 WimMDExp 导出 工 
具 的 输入 ; 不 能 直接 引用 .winmdobj 文件 自身 。 


除非 使 用 /out 选项 ， 否 则 输出 文件 的 名 称 采 用 第 一 个 输入 文件 的 名 称 。 不 需要 使 用 
Main 方法 。 


TTE DS IRIS ABE /target:winmdobj 选项 ， 则 在 指定 下 一 个 /out 或 
Itarget:module 选项 之 前 ， 会 使 用 所 有 文件 来 创建 Windows 程序 。 


在 Visual Studio IDE 中 为 Windows 应 用 两 店 应 用 程 
序 设置 此 编译 器 选项 

1. 在 “解决 方案 资源 管理 器 ”中 ， 打 开 项 目的 快捷 菜单 ， 然 后 选择 “属性 ”。 

2. 选择 “应 用 程序 "选项 卡 。 

3. 在 “输出 类 型 "列表 中 ， 选 择 “WinMD 文件 ”。 

“WinMD 文件 ”选项 只 能 用 于 Windows 8.x 应 用 商店 应 用 模板 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参阅 OutputType。 
以 下 命令 将 flename.cs 编译 为 一 个 中 间 .winmdobj 文件 。 
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csc /target:winmdobj filename.cs 


请 参阅 
/target (C£ Compiler Options) 
C£ Compiler Options 


Itarget:winmdobj (C£ 编译 器 选项 ) 1154 


/unsafe (CZ Compiler Options) 


lunsafe 编译 器 选项 允许 对 使 用 unsafe 关键 字 的 代码 进行 编译 。 
语法 


/unsafe 


备注 
有 关 不 安全 代码 的 更 多 信息 ， 请 参见 不 安全 代码 和 指针 (C# 编程 指南 ) o 
f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 生 成 ”属性 页 。 

3. 选中 “允许 不 安全 代码 ” 复 选 框 。 
有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 人 参见 AllowUnsafeBlocks。 
编译 不 安全 模式 的 in.cs : 


csc /unsafe in.cs 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


lutf8output (CZ Compiler Options) 
lutf8output 选项 使 用 UTF-8 编码 显示 编译 器 输出 。 
语法 
/utf8output 
各 注 
在 某 些 国际 配置 中 ， 编 译 器 输出 无 法 在 控制 台 上 正确 显示 。 在 这 些 配置 中 ， 请 使 用 
/utf8output 并 将 编译 器 输出 重 定向 到 文件 。 


此 编译 器 选项 在 Visual Studio 中 不 可 用 ， 且 不 能 通过 编程 方式 进行 更 改 。 


请 参阅 


C# Compiler Options 


/warn (C£ Compiler Options) 
/warn 选项 指定 编译 器 要 显示 的 警告 等 级 。 


吾 法 


/warn:option 


参数 
option 


您 希望 为 编译 显示 的 警告 等 级 : 较 小 的 数字 只 显示 高 严重 度 的 警告 ; MPRA, E 
示 的 警告 越 多。 有 效 值 为 0 到 4 : 


警告 P 

等 级 EDS 

0 关闭 iila ES 

1 显示 严重 的 和 警告 消 

2 显示 等 级 1 警告 以 及 某 些 不 太 严 重 的 警告 ， 如 关于 隐藏 类 成 员 的 警 
He 

3 显示 等 级 2 警告 以 及 某 些 不 太 严 重 的 警告 ， 例 如 有 关 总 是 计算 为 true 
或 false 的 表达 式 的 警告 。 

4 GR 


P 示 所 有 等 级 3 警告 以 及 信息 性 警告。 
备注 


PARTS 误 或 警告 的 信息 ， 可 以 在 帮助 索引 中 查找 错误 代码 。 有 关 获 得 错误 
人 言 息 的 其 他 方式 ， 请 参见 C# Compiler Errors, 
使 用 /warnaserror 可 将 所 有 的 警告 都 视 为 错误 。 可 以 使 用 /nowarn 禁用 某 些 警告 


Iw 是 /warn 的 缩写 形式 。 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 


1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “ 生 成 ”属性 页 。 

3. 修改 “警告 等 级 ”属性 。 

有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 WarningLevel。 
编译 in.cs 并 让 编译 器 仅 显 示 等 级 1 警告 : 


csc /warn:1 in.cs 


请 参阅 
C# Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


/warnaserror (C£ Compiler Options) 


Iwarnaserror-* 选项 将 所 有 和 警告 都 视 为 错误 
BR 


/warnaserror[<U>+</U> | -][:warning-list] 


备注 


P RED 为 警告 的 任何 消息 都 报告 为 错误 ， 并 且 暂 停 生 成 过 程 (不 生成 输出 文 


默认 情况 下 启用 /warnaserror-， 这 导致 警告 不 会 妨碍 生成 输出 文件 。 
/warnaserror 5 /warnaserror* 相同 ， 它 使 警告 被 视 为 错误 。 


(alt) 如 果 您 希望 只 将 几 个 特定 的 警告 视 为 错误 ， 可 以 指定 一 个 以 逗号 分 隔 的 列 
表 ， 其 中 列 出 被 视 为 错误 的 警告 编号 。 


使 用 /Warn 可 指定 您 希望 编译 器 显示 的 


fie 


s 


告 等 级 。 可 以 使 用 /nowarn 禁用 某 些 警 


wie 


f£ Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “ 生 成 ”属性 页 。 
3. 修改 “将 警告 视 为 错误 ”属性 。 
若 要 以 编程 方式 设置 此 编译 器 选项 ， 请 参见 TreatWarningsAsErrors。 


编译 in.cs 并 且 让 编译 器 不 显示 警告 : 


csc /warnaserror in.cs 
csc /warnaserror:642,649,652 in.cs 


请 


" 


阅 


C£ Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 


/warnaserror (C£ Compiler Options) 1160 


Iwin32icon (C# Compiler Options) 


Iwin32icon 选项 在 输出 文件 中 插入 .ico 文件 ， 这 样 .赋予 输出 文件 在 Windows 资源 
管理 器 中 的 所 需 外 观 。 


语法 


/win32icon:filename 


参数 


filename 


要 添加 到 输 出 文件 的 ICO 文件 。 

各 注 

可 以 使 用 资源 编译 器 创建 .ico 文件 。 编 译 Visual C++ 程序 时 将 调用 资源 编译 
器 ; ico 文件 是 从 .rc 文件 创建 的 。 


请 参见 /linkresource (用 于 引用 .NET Framework X eo 或 ,resource (用 于 
附加 .NET Framework 资源 文件 ) 。 要 导入 .res 文件 ， 请 参见 /win32res。 


在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 

2. 单 击 “应 用 程序 ”属性 页 。 

3. 修改 “应 用 程序 图 标 ” 属 性 。 


有 关 如 何以 编程 方式 设置 此 编译 器 选项 的 信息 ， 请 参见 Applicationlcon。 
编译 in.cs， 并 附加 .ico 文件 rf.ico 以 生成 in.exe : 


csc /win32icon:rf.ico in.cs 


请 


中 


阅 


C# Compiler Options 
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如 何 : 修改 项 目 属性 和 配置 设置 


/win32icon (C£ Compiler Options) 1162 


/win32manifest (CZ Compiler Options) 


使 用 /win32manifest i 2% n] LATS XE SE ERA Bl oh EL B) SES n] 44.47 (PE) 文件 中 的 用 
户 定义 的 Win32 应 用 程序 清单 文件 。 


语法 


/win32manifest: filename 


参数 


filename 

自 定 义 清 单 文件 的 名 称 和 位 置 。 

各 注 

默认 情况 下 ，Visual C# 编译 器 嵌入 指定 "aslnvoker 的 请 求 执行 级 别 的 应 用 程序 清 
单 。 它 在 生成 该 可 执行 文件 的 文件 夹 中 创建 清单 ， 如 果 使 用 Visual Studio， 该 文件 
夹 通常 为 bin\Debug 或 bin\Release。 如 果 要 提供 自 定义 清单 (例如 ， 指 


定 “highestAvailable” 或 “requireAdministrator” 的 请 求 执行 级 别 的 清单 ) ， 请 使 用 此 
选项 指定 文件 名 。 


8 注意 
此 选项 和 /win32res (C# Compiler Options) 选项 是 互 斥 的 。 如 果 尝 试 在 同一 命 
兮 行 中 同时 使 用 这 两 个 选项 ， 则 会 收 到 一 个 生成 错误 。 


如 果 应 用 程序 没有 用 于 指定 请 求 执 行 级 别 的 应 用 程序 清单 ， 则 会 受到 Windows 
Vista 的 用 户 帐 户 控制 功能 下 的 文件 /注册 表 虚 拟 化 的 影响 。 有 关 虚 拟 化 的 更 多 信 
息 ， 请 参见 The Windows Vista Developer Story: Windows Vista Application 
Development Requirements for User Account Control (UAC). 


如 果 满 足下 列 任 一 条 件 ， 则 应 用 程序 会 受到 虚拟 化 的 影响 : 
e 使 用 /nowin32manifest 选项 ， 并 且 在 随后 的 生成 步骤 中 未 提供 清单 ， 或 者 没 
有 通过 使 用 /win32res 选项 将 其 包含 在 Windows 资源 (.res) 文件 中 。 
e. 提供 的 自 定义 清单 未 指定 请 求 执 行 级 别 。 


Visual Studio 创建 默认 的 .manifest 文件 ， 并 将 该 文件 与 可 执行 文件 一 起 存储 在 
debug 和 release 目录 中 。 可 以 用 任意 文本 编辑 器 创建 一 个 清单 ， 然 后 将 该 文件 添 
加 到 项 目 中 ， 以 此 添加 自 定义 清单 。 或 者 ， 也 可 以 右 击 “ 解 决 方案 资源 管理 器 ”中 


的 “项 目 ” 图 标 ， 单 击 “ 添 加 新 项 ”， 然 7S 后 单 击 “ 应 用 程序 清单 文件 ”。 添加 完 新 的 或 现 
有 清单 文件 后 ， 该 文件 将 显示 在 “清单 "下拉 列表 中 。 有 关 详 细 信 息 ， 请 参阅 "项 目 设 
计 器 ”->" 应 用 程序 ”页 (CH). 


提供 应 用 程序 清单 的 操作 ， 可 以 作为 自 定 义 后 期 生成 步骤， 也 可 以 通过 使 用 
/nowin32manifest (C£ Compiler Options) 选项 作为 Win32 资源 文件 的 组 成 部 分 。 
如 果 希 望 应 用 程序 受到 Windows Vista 的 文件 /注册 表 虚 拟 化 的 影响 向 ， 请 使 用 该 选 
项 。 这 会 阻止 编译 器 在 可 迁移 可 执行 (PE) 文件 中 创建 和 族人 默认 清单 。 


下 面 的 示例 演示 Visual C# 编译 器 插入 到 PE 中 的 默认 清单 。 
8 注意 


编译 器 将 一 个 标准 应 用 程序 名 称 "*MyApplication.app" 插 入 到 xml 中 。 这 是 一 种 
使 应 用 程序 可 以 在 Windows Server 2003 Service Pack 3 上 运行 的 解决 方法 。 


<?xml version="1.0" encoding="utf-8" standalone="yes"?> 
«assembly xmlns="urn:schemas-microsoft-com:asm.vi" manifestVersion: 
<assemblyIdentity version="1.0.0.0" name="MyApplication.app"/> 
<trustInfo xmlns="urn:schemas-microsoft-com:asm.v2"> 
<security> 
«requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3' 
<requestedExecutionLevel level="asInvoker"/> 
</requestedPrivileges> 
</security> 
«/trustInfo» 
«/assembly» 





请 参阅 


C£ Compiler Options 
/nowin32manifest (C# Compiler Options) 
如 何 : 修改 项 目 属性 和 配置 设置 


/win32res (C£ Compiler Options) 


Iwin32res 选项 在 输出 文件 中 插入 Win32 资源 。 
语法 


/win32res:filename 


参数 


filename 


要 添加 到 输 出 文件 的 资 T1 源 文件 。 

各 注 

Win32 资源 文件 可 以 用 资源 编译 器 创建 。 在 编译 Visual C++ 程序 时 会 调用 资源 编 
译 器 ; res 文件 是 用 .rc 文件 创建 的 。 


Win32 资源 可 以 包含 版 本 或 位 图 (图标) 信息， 这 些 信息 有 助 于 在 文件 资源 管理 器 
中 标识 您 的 应 用 程序 。 如 果 不 指定 /win32res， 编 译 器 将 根据 程序 集 版 本 生成 版 本 


信息 NO 


请 参见 /linkresource (用 于 引用 .NET Framework 资源 文件 ) 3X /resource (用 于 
附加 .NET Framework 资源 文件 ) 。 
在 Visual Studio 开发 环境 中 设置 此 编译 器 选项 
1. 打开 项 目的 “属性 ”页 。 
2. 单 击 “应 用 程序 ”属性 页 。 
3. 单 击 “ 资 源 文件 ”按钮 ， 然 后 使 用 组 合 框 选择 文件 。 
编译 in.cs， 并 附加 Win32 资源 文件 rf.res 以 生成 in.exe : 


csc /win32res:rf.res in.cs 


请 


中 


阅 
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C£ Compiler Options 
如 何 : 修改 项 目 属性 和 配置 设置 


/win32res (C# Compiler Options) 1166 


C# Compiler Errors 
某 些 C# 编译 器 错误 有 相应 的 主题 说 明 错 误 生 成 的 原因 ， 在 某 些 情况 下 还 说 明了 如 
何 修复 错误 。 若 要 了 解 某 个 特定 错误 消息 是 否 有 帮助 信息 ， 请 使 用 以 下 步骤 之 一 。 
e 查看 错误 号 (例如 CS0029)， 在 “输出 "窗口 为 ， 然 后 搜索 MSDN. 
e 选择 该 错误 号 (例如 CS0029)， 在 “输出 ?窗口 ， 然 后 选择 F1 键 。 
。 在 “索引 "中 的 “查找 ” 框 中 键入 错误 号 。 


如 果 这 些 步骤 都 不 会 产生 有 关 该 错误 的 信息 ， 请 转 到 结尾 此 页 ， 然 后 发 送 包 含 错 误 
数 或 文本 的 反馈 。 


ARE CH 中 如 何 配置 错误 和 警告 选项 的 信息 ， 请 参见 “项 目 设计 器 ”->“ 生 成 "页 
(C#)。 


MN = 
Eg TERR 


以 下 说 明 中 的 某 些 Visual Studio 用 户 界 面 元 素 在 计算 机 上 出 现 的 名 称 或 位 置 可 
能 会 不 同 。 这 些 元 素 取 决 于 你 所 使 用 的 Visual Studio 版 本 和 你 所 使 用 的 设置 。 
有 关 详 细 信 息 ， 请 参阅 个 性 化 Visual Studio IDE, 


请 参阅 

C# Compiler Options 

Sorry, we don't have specifics on this C# error 
“项 目 设 计 器 ”->“ 生 成 "页 (CH) 

/warn (C£ Compiler Options) 


/nowarn (C£ Compiler Options) 


Compiler Error CS0001 
内 部 编译 器 错误 


尝试 确 定编 译 器 是 否 由 于 无 法 分 析 意 外 的 语法 而 失败 。 如 果 重 复 收 到 此 错误 ， 请 与 
Microsoft 联系 。 


Compiler Error CS0006 


未 能 找到 元 数据 文件 "<DLL 名 称 >” 
编译 了 程序 并 给 它 显 式 传递 了 包含 元 数据 的 文件 的 名 称 ， 但 没有 找到 .dll。 有 关 更 


多 信息 ， 请 参见 /reference (C# Compiler Options)。 


Compiler Error CS0007 


意外 的 公共 语言 运行 时 初始 化 错误 一 “description” 

如 果 未 能 加 载运 行 时 ， 则 会 发 生 此 错误 。 如 果 计 算 机 上 不 存在 编译 器 党 试 加 载 的 公 
共 语 言 运行 时 的 版 本 ， 或 者 公共 语言 运行 时 的 安装 或 配置 已 损坏 ， 则 可 能 发 生 此 错 
误 。 

如 果 更 改 了 csc.exe.config 文件 ， 则 可 能 发 生 上 述 情况 。 此 文件 是 在 安装 期 间 配 置 
的 ， 不 应 更 改 。 如 果 csc.exe.config 文件 有 可 能 已 被 和 更改， 请 检查 该 文件 ， 确 保 计 
算 机 上 存在 该 文件 中 指定 的 运行 时 的 版 本 。 如 果 存 在 正确 的 版 本 ， 它 可 能 已 损坏 。 


请 重新 安装 公共 语言 运行 时 。 


编译 十 错误 CS0015 

类 型 “type” 的 名 称 太 长 

用 户 定 义 类 型 的 完全 限定 名 必须 少 于 1024 个 字符 ， 包 括 句 点 。 
下 面 的 示例 生成 CS0015 : 


// CS0015.cs 


// Remove a C from one of the namespace names or the class name to 
// reducing the number of characters in the qualified class name t« 


namespace CC 


// The following namespace name has 510 characters. 
namespace CCC510charsCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC( 


{ 
// The following class name has 510 characters. The qualif: 
// CC.ccc510chars...C.cccc510chars..C (namespace.namespace.cl: 
// characters, which causes compiler error CS0015. 
public class CCCC510charsCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC( 
{ 
public static void Main() 
{ 
} 
} 
} 





Compiler Error CS0016 


未 能 写 入 输出 文件 “< 文件 >”， 原 因 是 “< 原因 >” 


编译 器 未 能 写 人 输出 文件 。 检 查 文件 的 路 径 ， 确 保 文件 存在 。 如 果 该 位 置 已 经 存在 
一 个 以 前 生成 的 文件 ， 请 确保 该 文件 可 写 入 ， 并 且 当 前 没有 进程 将 该 文件 锁定 。 例 
如 ， 确 保 在 尝试 生成 时 可 执行 文件 没有 运行 。 


Compiler Error CS0019 


运算 符 “operator” 无 法 应 用 在 “type” 和 “type” 类 型 的 操作 数 


对 不 支持 二 元 运算 符 的 数据 类 型 应 用 该 运算 符 。 例 如 ， 您 不 能 对 字符 串 使 用 || 运算 
符 ， 不 能 对 bool 变量 使 用 +、-、< 或 > 运算 符 ， 并 且 不 能 将 == 运 算 符 与 struct 类 
型 一 起 使 用 〈 除 非 该 类 型 显 式 重 载 了 该 运算 符 ) 。 


如 果 在 义理 类 类 型 时 遇 到 此 错误 ， 则 原因 是 该 类 未 重 载运 算 符 。 有 关 详 细 信 息 ， 请 
参阅 可 重 载运 算 符 (CH 编程 指南 ) o 


在 下 面 的 示例 中 ， 将 在 两 个 位 置 生成 CS0019， 原 因 是 C# 中 的 bool 不 能 转换 为 


int。 将 减法 运算 符 应 用 于 字符 串 时 ， 还 会 生成 CS0019。 请 注意 ， 加 法 运算 符 (+) 
可 与 字符 串 操作 数 一 起 使 用 ， 因 为 String 类 会 重 载 该 运算 符 以 执行 字符 串 串联 。 


static void Main() 


{ 
bool result = true; 
if (result > 0) //CS0019 
// Do something. 
} 
int i - 1; 
// You cannot compare an integer and a boolean value. 
if (i -- true) //CS0019 
//Do something... 
} 
// The following use of == causes no error. It is the comparis‘ 
// an integer and a boolean value that causes the error in the 
// previous if statement. 
if (result -- true) 
//Do something... 
} 
string s = "Just try to subtract me."; 
float f - 100 - s; // CS0019 
} 





在 下 面 的 示例 中 ， 必 须 在 ConditionalAttribute 外 指定 条 件 逻 辑 。 只 能 向 
ConditionalAttribute 传递 一 个 预定 义 符号 。 


下 面 的 示例 生成 CS0019。 


// CS0019 a.cs 

// compile with: /target:library 
using System.Diagnostics; 

public class MyClass 


{ 
[ConditionalAttribute("DEBUG" || "TRACE") ] // CS0019 
public void TestMethod() {} 
// OK 
[ConditionalAttribute("DEBUG"), ConditionalAttribute("TRACE")] 
public void TestMethod2() {} 
} 


<] m zw] xj 
请 参阅 


运算 符 (CH 编程 指南 ) 
隐 式 数值 转换 表 (CH 参考 ) 


Compiler Error CS0029 


无 法 将 类 型 “type” 隐 式 转 换 为 “type” 


编译 器 要 求 显 式 转换 。 例 如 ， 可 能 需要 将 右 值 转换 成 与 左 值 相同 的 类 型 。 或 者 必须 
提供 转换 例 程 以 支持 某 些 运算 符 重 载 。 


在 将 某 个 类 型 的 变量 赋 给 其 他 类 型 的 变量 时 必须 进行 转换 。 当 在 不 同类 型 的 变量 之 
间 进 行 赋值 时 ， 编 译 器 必须 将 赋值 运算 符 右 边 的 类 型 转换 为 该 赋值 运算 符 左 边 的 类 
型 。 假 设 有 下 面 的 代码 : 


int i = 50; 
long lng = 100; 
i = lng; 


i-Ing; 进行 赋值 运算 ， 但 赋值 运算 符 左 右 两 边 变量 的 数据 类 型 不 匹配 。 进 行 赋值 

前 ， 编 译 器 将 变量 Ing 〈 类 型 为 long) 隐 式 转换 为 int。 此 为 隐 式 转换 ， 原 因 是 没 

代码 显 式 指示 编译 器 执行 此 转换 。 此 代码 的 问题 在 于 上 述 转换 被 视 为 收缩 转换 ， 而 
编译 器 不 允许 进行 隐 式 收缩 转换 ， 原 因 是 可 能 会 去 失 数据 。 


如 果 转 换 后 的 数据 类 型 所 占用 的 内 存 存储 空间 比 转换 前 的 数据 类 型 所 占用 的 少 ， 则 
存在 收缩 转换 。 例 如 ， 将 long 类 型 转换 为 int 类 型 就 被 视 为 收缩 转换 。long 类 型 占 
用 8 个 字 节 的 内 存 ， 而 int 类 型 只 占用 4 个 字 节 。 若 要 查看 数据 丢失 如 何 发 生 ， 请 
考虑 以 下 示例 : 


int i = 50; 
long lng = 3147483647; 
i = lng; 


变量 Ing 现在 包含 的 值 无 法 存储 在 变量 i 中， 原因 是 该 值 太 大 。 如 果 要 将 该 值 转换 
为 int 类 型 ， 就 会 丢失 一 些 数 据 ， 并 且 转 换 后 的 值 不 同 于 转换 前 的 值 。 


扩大 转换 与 收缩 转换 相反 。 对 于 扩大 转换 ， 转 换 后 的 数据 类 型 占用 的 内 存 存储 空间 
比 转换 前 的 数据 类 型 占用 的 多 。 下 面 是 一 个 扩大 转换 的 示例 : 


int i = 50; 
long lng = 100; 
lng = i; 


请 注意 此 代码 示例 和 第 一 个 示例 之 间 的 区 别 。 这 里 ， 变 量 Ing 位 于 赋值 运算 符 的 左 
边 ， 所 以 它 是 赋值 的 目标 。 在 可 以 进行 赋值 前 ， 编 译 器 必须 将 变量 i (类 型 为 int) 
隐 式 转换 为 bong 类 型 。 这 是 一 个 扩大 转换 ， 因 为 我 们 是 从 一 个 占用 4 个 字 节 内 存 


的 类 型 (int) 转换 为 一 个 占用 8 个 字 节 内 存 的 类 型 (long)。 由 于 不 会 发 生 数据 丢失 ， 
所 以 允许 进行 隐 式 扩大 转换 。 任 何 可 以 用 int 类 型 存储 的 值 也 可 以 用 long 类 型 存 
fifo 


我 们 知道 隐 式 收缩 转换 是 不 允许 的 ， 因 此 为 了 能 够 编译 这 些 代 码 ， 就 需要 显 式 转换 
数据 类 型 。 显 式 转 换 是 使 用 强制 转换 来 完成 的 。 强 制 转换 是 C# 中 用 来 描述 将 一 种 
数据 类 型 转换 为 另 一 种 数据 类 型 的 术语 。 若 要 编译 这 些 代码 ， 我 们 需要 使 用 以 下 语 


/ 


int i = 50; 
long lng = 100; 
i = (int) lng; // cast to int 


第 三 行 代码 通知 编译 器 在 进行 赋值 前 ， 将 变量 Ing (KAA long) 显 式 转换 为 int X 
型 。 切 记 ， 使 用 收缩 转换 可 能 会 丢失 数据 。 使 用 收缩 转换 时 应 小 心 ， 而 且 即 使 可 以 
编译 代码 ， 也 可 能 会 在 运行 时 获得 意外 的 结果 。 


此 讨论 只 针对 值 类 型 。 使 用 值 类 型 就 是 直接 使 用 存储 在 变量 中 的 数据 。 但 .NET 
Framework 还 具有 引用 类 型 。 使 用 引用 类 型 就 是 使 用 对 变量 的 引用 ， 而 不 是 使 用 实 
际 数 据 。 引 用 类 型 的 示例 是 类 、 接 口 和 数组 。 不 能 隐 式 或 显 式 地 将 一 个 引用 类 型 转 
换 为 其 他 引用 类 型 ， 除 非 编 译 器 允许 特定 的 转换 或 可 以 实现 相应 的 转换 运算 符 。 


下 面 的 示例 生成 CS0029 : 


// CS0029 .cs 
public class MyInt 


{ 
private int x = 0; 
// Uncomment this conversion routine to resolve CS0029 
Vas 
public static implicit operator int(MyInt i) 
{ 
return 1.x; 
} 
Ey 
public static void Main() 
{ 
MyInt myInt = new MyInt(); 
int i = myInt; // CS0029 
} 
} 
请 参阅 


转换 运算 符 (CH 编程 指南 ) 


Compiler Error CS0034 


运算 符 “operator" 对 于 “type1”" 和 “type2” 类 型 的 操作 数 具有 二 义 性 


运算 符 用 在 了 两 个 对 象 上 ， 并 且 编 译 器 找到 多 个 转换 。 因 为 转换 必须 是 唯一 的 ， 
此 必须 进行 一 次 强制 转换 ， 或 者 使 其 中 一 个 转换 成 为 显 式 转换 。 有 关 更 多 信息 ， 请 
参见 转换 运算 符 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0034 : 


// CS0034.cs 
public class A 


{ 
// allows for the conversion of A object to int 
public static implicit operator int (A s) 
{ 
return 0; 
} 
public static implicit operator string (A i) 
{ 
return null; 
} 
} 
public class B 
{ 


public static implicit operator int (B s) 
// one way to resolve this CS0034 is to make one conversion exp. 
// public static explicit operator int (B s) 


{ 
return 0; 
} 
public static implicit operator string (B i) 
{ 
return null; 
} 
public static implicit operator B (string i) 
{ 
return null; 
} 
public static implicit operator B (int i) 
{ 
return null; 
} 


} 


public class C 


public static void Main () 


1 
A a - new A(); 
B b = new B(); 
b=b+a; // CS0034 
// another way to resolve this CS0034 is to make a cast 
// b= b + (anit ja: 
} 





在 C# 1.1 中 ， 一 个 编译 器 Bug 使 其 能 够 定义 一 个 类 ， 在 其 中 实现 针对 int 和 bool 
的 用 户 定义 的 隐 式 转换 ， 并 对 该 类 型 的 对 象 使 用 按 位 AND 运算 符 (&)。 在 CH 2.0 
中 ， 已 修复 此 Bug 以 使 编译 器 符合 CH 规范 ， 因 此 以 下 代码 现在 将 导致 错误 
CS0034 : 


namespace CS0034 
; class TestClass2 
public void Test() 
TestClass o1 - new TestClass(); 


TestClass 02 = new TestClass(); 
TestClass 03 = o1 & o2; //CS0034 


j 


class TestClass 


public static implicit operator int(TestClass o) 


{ 
return 1; 
} 
public static implicit operator TestClass(int v) 
{ 
return new TestClass(); 
} 
public static implicit operator bool(TestClass o) 
{ 
return true; 
} 
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Compiler Error CS0038 


FAH BRE X BY “type2’ Riz iy] IHE 3: BE “type1 "的 非 静 态 成 员 


PRISER zb FT AF BRE X XQ. GHMDAFREX, RFRVUAME static. f 
则 ， 必 须 创 建 外 部 类 的 实例 。 有 关 更 多 信息 ， 请 参见 典 套 类 型 (CH 编程 指南 ) 。 


下 面 的 示例 生成 CS0038 : 


// CS0038.cs 

class OuterClass 

{ 
public int count; 
// try the following line instead 
// public static int count; 


class InnerClass 
void func() 
// or, create an instance 
// OuterClass class_inst = new OuterClass(); 


// int count2 = class_inst.count; 
int count2 = count; // CS0038 


} 
} 
public static void Main() 
{ 
} 


Compiler Error CS0039 


无 法 通过 引用 转换 、 装 箱 转换 、 取 消 装 箱 转 换 、 包 装 转 换 或 Null 类 型 转换 将 类 
型 type 人 转换 为 "type2” 


继承 、 PULL Sd sis Loud as (CH 2E) 运算 符 的 转换 。 有 关 更 多 信 
息 ， 请 参见 转换 运算 符 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0039。 


// CS0039.cs 
using System; 


class A 
{ 
} 
class B: A 
{ 
} 
class C: A 
{ 
} 
class M 
{ 
static void Main() 
{ 
Aa= new C(); 
B b = new B(); 
CEG 
// This is valid; there is a built-in reference 
// conversion from A to C. 
c =a as C; 
//The following generates CS0039; there is no 
// built-in reference conversion from B to C. 
= b as C; // CS0039 
} 


Compiler Error CS0050 


可 访问 性 不 一 致 : 返回 类 型 "type” 比 方法 “method” 的 可 访问 性 低 
方法 的 返回 类 型 和 形 参 表 中 引用 的 每 个 类 型 都 必须 至 少 具 有 和 方法 自身 相同 的 可 访 
问 性 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0050， 因 为 没有 为 MyClass 提供 任何 可 访问 性 修饰 符 ， 因 此 它 
的 可 访问 性 默认 为 private。 


// CS0050.cs 

class MyClass //accessibility defaults to private 
// try the following line instead 

// public class MyClass 


t 
} 


public class MyClass2 


public static MyClass MyMethod() // CS0050 
{ 


} 


public static void Main() { } 


return new MyClass(); 


Compiler Error CS0051 


可 访问 性 不 一 致 : 参数 类 型 “type” 比 方法 “method” 的 访问 性 低 


方法 的 返回 类 型 和 形 参 表 中 引用 的 每 个 类 型 都 必须 至 少 具 有 和 方法 自身 相同 的 可 访 
问 性 。 请 确保 方法 签名 中 使 用 的 类 型 不 会 因为 省 略 public 修饰 符 而 意外 变 为 专 
用 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0051 : 


// CS0051.cs 
public class A 
1 
// Try making B public since F is public 
// B is implicitly private here 
class B 
{ 
} 


public static void F(B b) // CS0051 
{ 
} 


public static void Main() 
{ 
} 


Compiler Error CS0052 


可 访问 性 不 一 致 : 字段 类 型 “type” 比 字段 “field” 的 访问 性 低 


字段 类 型 的 可 访问 性 不 能 比 字段 本 身 的 可 访问 性 低 ， 因 为 所 有 的 公共 构造 都 必须 返 
回 公共 的 可 访问 对 象 。 


下 面 的 示例 生成 CS0052 : 


// CS0052 .cs 
public class MyClass2 


{ 
// The following line causes an error because the field, M, is 
// as public, but the type, MyClass, is private. Therefore the 
// less accessible than the field. 
public MyClass M; // CS0052 
private class MyClass 
{ 
// One way to resolve the error is to change the accessibility 
// to public. 
//public class MyClass 
// Another solution is to change the accessibility of the fiel 
// private MyClass M; 

} 


public class MainClass 


public static void Main() 





CHART 

访问 修饰 符 (CH 参考 ) 
可 访问 性 级 别 (CH 参考 ) 
(Esp (CH 参考 ) 


Compiler Error CS0071 


事件 的 显 式 接口 实现 必须 使 用 事件 访问 器 语法 

当 显 式 实现 在 接口 中 声明 的 事件 时 ， 您 必须 手动 提供 通常 由 编译 器 提供 的 add 和 
remove 事件 访问 器 。 访 问 器 代码 可 将 类 中 的 接口 事件 连接 到 另 一 事件 〈 稍 后 在 本 
主题 中 演示 ) ， 或 连接 到 其 自身 的 委托 类 型 。 有 关 更 多 信息 ， 请 参见 如 何 : 实现 接 
口 事件 (CH 编程 指南 ) o 

下 面 的 示例 生成 CS0071。 

// CS0071.cs 

public delegate void MyEvent(object sender); 


interface ITest 


: event MyEvent Clicked; 

} 

class Test : Itest 

: event MyEvent ITest.Clicked; // CS0071 
" // try the following code instead 


private MyEvent clicked; 


event MyEvent Itest.Clicked 


add 

clicked += value; 
} 
remove 

clicked -= value; 
} 


} 


public static void Main() { } 


“7 


} 


Compiler Error CS0103 


当前 上 下 文中 不 存在 名 称 “identifier” 


尝试 使 用 类 、 命 名 空间 或 范围 中 不 存在 的 名 称 。 检 查 名 称 的 拼写 ， 并 检查 正在 使 用 
的 目录 和 程序 集 引 用 ， 确 保 您 尝试 使 用 的 名 称 可 用 。 


如 果 在 循环 或 者 try 或 if 块 中 声明 一 个 变量 ， 然 后 尝试 从 封闭 代码 块 或 一 独立 代码 
块 访问 此 变量 ， 经 常会 发 生 此 错误 。 如 下 面 的 示例 所 示 。 
using System; 
class MyClassi 
public static void Main() 
{ - 


// The following declaration is only available inside 1 
MyClassi conn = new MyClass1i(); 


catch (Exception e) 


// The following expression causes error CS0103, becau: 
// conn only exists in the try block. 
if (conn !- null) 

Console.WriteLine("{0}", e); 





下 面 的 示例 解决 错误 。 


using System; 


class MyClass2 


( 


public static void Main() 


( 


// To resolve the error in the example, the first step is ! 
// move the declaration of conn out of the try block. The 1 
// declaration is available throughout the Main method. 
MyClass2 conn - null; 


try 

{ 
// Inside the try block, use the conn variable that yot 
// previously. 
conn - new MyClass2(); 

} 


catch (Exception e) 


// The following expression no longer causes an error, 
// the declaration of conn is in scope. 
if (conn !- null) 

Console.WriteLine("{0}", e); 





Compiler Error CS0106 


修饰 符 "modifier 对 该 项 无 效 
类 或 接口 成 员 是 用 无 效 的 访问 修饰 符 标 记 的 。 下 列 示例 描述 了 一 些 无 效 的 修饰 符 : 
e 在 接口 方法 上 不 允许 使 用 static 和 public 修饰 符 。 


e 在 显 式 接口 声明 上 不 允许 使 用 public 关键 字 。 在 这 种 情况 下 ， 请 从 显 式 接口 
声明 中 移 除 public 关键 字 。 
e 在 显 式 接口 声明 上 不 允许 使 用 abstract 关键 字 ， 因 为 显 式 接口 实现 永远 不 能 被 
BE. 
在 以 前 的 Visual Studio 版 本 中 ， 不 允许 在 类 上 使 用 static 修饰 符 ， 但 允许 static 
类 以 Microsoft Visual Studio 2005 开头 。 


有 关 更 多 信息 ， 请 参见 接口 (CH 编程 指南 ) 
下 面 的 示例 生成 CS0106. 


// CS0106.cs 
namespace MyNamespace 


( 


interface I 


void m(); 
static public void f(); // CS0106 


} 


public class MyClass 
{ 
public void I.m() {} // CS0106 
public static void Main() {} 
} 
} 


Compiler Error CS0115 


"function" : 没有 找到 适合 的 方法 来 重 写 


方法 被 标记 为 override， 但 编译 器 未 找到 可 重 写 的 方法 。 有 关 更 多 信息 ， 请 参见 
override (C£ 参考 ) 和 了 解 何 时 使 用 Override 和 New 关键 字 (C 编程 指南 ) o 


下 面 的 示例 生成 CS0115。 可 以 用 下 列 两 种 方法 之 一 解决 CS0115 : 
e 从 MyClass2 的 方法 中 移 除 override 关键 字 。 
e 将 MyClass1 FAVE MyClass2 的 基 类 。 
// CS0115.cs 
namespace MyNamespace 
: abstract public class MyClass1 


public abstract int f(); 
} 


abstract public class MyClass2 
public override int f() // CS0115 
return 0; 
public static void Main() 


t 
} 


Compiler Error CS0116 


命名 空间 并 不 直接 包含 诸如 字段 或 方法 之 类 的 成 员 


在 namespace 内 ， 编 译 器 只 接受 类 、 结 构 、 联 合 、 枚 举 、 接 口 和 委托 。 当 C/C++ 
开发 人 员 忘 记 了 在 C# 中 ， 方 法 和 变量 必须 在 结构 或 类 中 定义 时 ， 通 常会 生成 此 错 
误 。 有关 更 多 信息 ， 请 参见 C# 程序 的 通用 结构 (CH 编程 指南 ) 。 


下 面 的 示例 生成 CS0116 : 


// CS0116.cs 
namespace x 


( 


using System; 


// method must be in class/struct 
void Method(string str) // CS0116 
t 


j 


// To fix the error, you must 
// enclose a method in a class: 
class Program 


Console.WriteLine(str); 


void Method2(string str) 


Console.WriteLine(str); 


请 参阅 


还 


CH 程序 的 通用 结构 (C# 编程 指南 ) 
类 和 结构 (CH 编程 指南 ) 
命名 空间 (CH 编程 指南 ) 


Compiler Error CS0120 


非 静 态 的 字段 、 方 法 或 属性 "member 要 求 对 象 引用 


必须 首先 创建 对 象 实例 ， 才 能 使 用 非 静态 的 字段 、 方 法 或 属性 。 有 关 静 态 方法 的 更 
多 信息 ， 请 参见 静态 类 和 静态 类 成 员 (CH 编程 指南) 。 有 关 创 建 类 的 实例 的 更 多 
信息 ， 请 参见 实例 构造 画 数 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0120 : 


// CS0120 1.cs 
public class MyClass 
1 
// Non-static field 
public int i; 
// Non-static method 
public void f(){} 
// Non-static property 
int Prop 
{ 
get 
{ 


} 
} 


public static void Main() 
{ 
i = 10;  // CS0120 
f();  // CS0120 
int p - Prop; // CS0120 
// try the following lines instead 
// MyClass mc - new MyClass(); 
// mc.i - 10; 
// mc.f(); 
// int p = mc.Prop; 


return 1; 


如 果 从 静态 方法 调用 非 静 态 方法 ， 也 会 生成 CS0120， 如 下 所 示 : 


// CS0120_2.cs 
// CS0120 expected 
using System; 


public class MyClass 


{ 
public static void Main() 
{ 
TestCall();  // CS0120 
// To call a non-static method from Main, 
// first create an instance of the class. 
// Use the following two lines instead: 
// MyClass anInstanceofMyClass - new MyClass(); 
// anInstanceofMyClass.TestCall(); 
} 
public void TestCall() 
{ 
} 
} 


同样 ， 静 态 方法 不 能 调用 实例 方法 ， 除 非 显 式 给 它 提 供 了 类 的 实例 ， 如 下 所 示 : 


// CS0120_3.cs 
using System; 


public class MyClass 
{ 


public static void Main() 


{ 
} 


do_it("Hello There"); // CS0120 


private void do_it(string sText) 
// You could also add the keyword static to the method definitic 
// private static void do it(string sText) 


í 


Console.WriteLine(sText); 





请 参阅 


类 和 结构 (CH 编程 指南 ) 


Compiler Error CS0122 


不 可 访问 "member， 因 为 它 受 保护 级 别 限制 


类 成 员 的 访问 修饰 符 禁 止 访问 该 成 员 。 有 关 更 多 信息 ， 请 参见 访问 修饰 符 (C# 编 
程 指南 ) 。 
出 现 此 错误 (未 在 下 面 的 示例 中 显示 ) 的 一 个 原因 是 : 在 友 元 程序 集 的 目标 上 省 略 


了 lout 编译 器 标志 。 有 关 更 多 信息 ， 请 参见 友 元 程序 集 (C# 和 Visual Basic) 和 
/out (C# Compiler Options) 


下 面 的 示例 生成 CS0122 : 


// CS0122.cs 
public class MyClass 


// Make public to resolve CS0122 
void MyMethod() 


{ 
} 
} 
public class MyClass2 
{ 
public static int Main() 
{ 
MyClass a = new MyClass(); 
// MyMethod is private 
a.MyMethod(); // CS0122 
return 0; 
} 


Compiler Error CS0134 


“variable” 的 类 型 为 “type”。 只 能 用 null 对 引用 类 型 (字符 串 除 外 ) 的 常量 字段 进行 初 
始 化 。 


常量 表达 式 是 可 在 编译 时 可 完全 计算 的 表达 式 。 由 于 应 用 new 运算 符 是 创建 引用 类 
型 的 非 空 值 的 唯一 方法 ， 并 且 常 量 表达 式 中 不 允许 使 用 new 运算 符 ， 因 此 除 字符 串 
外 ， 引 用 类 型 常量 的 唯一 可 能 值 为 null。 


如 果 党 试 创建 const 字符 串 数 组 时 遇 到 此 错误 ， 则 解决 方案 是 使 该 数组 成 为 只 读数 
组 ， 并 在 构造 男 数 中 将 其 初始 化 。 


下 面 的 示例 生成 CS0134。 


// CS0134.cs 
// compile with: /target:library 
class MyTest {} 


class MyClass 


{ 
const MyTest test = new MyTest(); // CS0134 


/ /OK 
const MyTest test2 - null; 
const System.String test3 = "test"; 


Compiler Error CS0151 


应 输入 整 型 值 
在 需要 整 型 数据 类 型 的 情况 中 使 用 了 变量。 有关 更 多 信息 ， 请 参见 类 型 (CH sie 
指南 ) 。 


当 没 有 转换 或 者 可 用 的 隐 式 转换 导致 了 不 明确 的 情形 时 ， 会 出 现 此 错误 。 下 面 的 示 
例 生成 CS0151. 


// CS0151.cs 
public class MyClass 


{ 
public static implicit operator int (MyClass aa) 
{ 
return 0; 
} 
public static implicit operator long (MyClass aa) 
{ 
return 0; 
} 
public static void Main() 
{ 
MyClass a = new MyClass(); 
// Compiler cannot choose between int and long 
switch (a) // CS0151 
// try the following line instead 
// switch ((int)a) 
case 1: 
break; 
} 
} 
} 


在 Visual Studio 2008 及 更 高 版 本 中 ，void 方法 调用 会 生成 CS0151。 通 过 调用 返 
回 整 数 类 型 (如 int 或 long). 的 方法 可 以 修复 该 错误 。 


class C 


{ 
static void Main() 
{ 
switch (M()) // CS0151 
default: 
break; 
} 
} 
static void M() 
{ 
} 


a it as 8 ix CS0163 
控制 不 能 从 一 个 case 4 A(“label”) t FEI 5 — case 标签 


«switch 语句 包含 多 个 时 开关 部 分 ， 使 用 以 下 关键 字 之 一 ， 必 须 显 式 终 止 每 节 ， 其 
中 包括 最 后 一 个 : 


e return 

e goto 

e break 

e throw 

e continue 


如 果 要 由 一 部 分 到 下 一 部 分 实现 “贯穿 ?的 行为 ， 使 用 goto case # 有 关 更 多 信息 和 
示例 ， 请 参见 switch (C# 参考 ) 。 


下 面 的 示例 生成 CS0163。 


// CSo163 .cs 
public class MyClass 
{ 


public static void Main() 


( 


int i = 0; 


switch (i) // CS0163 
{ 
// Compiler error CS0163 is reported on the following - 
case 1: 
i++; 
// To resolve the error, uncomment one of the following 
// return; 
// break; 
// goto case 3; 


case 2: 
i++; 


return; 


case 3: 
i = 0; 
return; 


// Compiler error CS0163 is reported on the following - 
default: 

Console.WriteLine("Default"); 

// To resolve the error, uncomment the following 1: 
//break; 





Compiler Error CS0165 


使 用 了 未 赋值 的 局 部 变量 "name” 


C# 编译 器 不 允许 使 用 未 初始 化 的 变量 。 如 果 编 译 器 检测 到 使 用 了 可 能 未 初始 化 的 
变量 ， 就 会 生成 编译 错误 CS0165。 有 关 详 细 信 息 ， 请 参阅 字段 (CH 编程 指 

南 ) 。 请 注意 ， 当 编译 器 遇 到 可 能 会 导致 使 用 未 赋值 变量 的 构造 时 ， 即 使 您 的 特定 
代码 不 会 使 用 该 变量 ， 也 会 生成 此 错误 。 这 样 可 以 避免 对 明确 赋值 使 用 过 度 复 条 的 
规则 。 


有 关 更 多 信息 ， 请 参见 
http://blogs.msdn.com/ericlippert/archive/2006/08/18/706398.aspx. 


下 面 的 示例 生成 CS0165 : 


// CS0165.cs 
using System; 


class MyClass 


{ 
public int i; 
} 
class MyClass2 
{ 
public static void Main(string[] args) 
{ 
// i and j are not initialized. 
int i, j; 
// You can provide a value for args[0] in the 'Command line 
// text box on the Debug tab of the project Properties wini 
if (args[0] == "test") 
{ 
1 = 0; 
} 
// If the following else clause is absent, i might not be 
// initialized. 
//else 
//4{ 
// i-21; 
//} 
// Because i might not have been initialized, the following 
// line causes CS0165. 
Jasa; 
// To resolve the error, uncomment the else clause of the [ 
// if statement, or initialize i when you declare it. 
// The following example causes CS0165 because myInstance : 
// declared but not instantiated. 
MyClass myInstance; 
// The following line causes the error. 
myInstance.i - 0; 
// To resolve the error, replace the previous declaration v 
// the following line. 
//MyClass myInstance - new MyClass(); 
} 
} 





编译 器 错误 CS0165 在 递 当 委托 定义 来 生成 。 可 以 通过 在 以 下 两 个 语句 中 定义 委托 
可 避免 此 错误 ， 以 便 在 变量 初始 化 之 前 ， 不 使 用 变量 。 下 面 的 示例 演示 错误 和 解决 
方案 。 


class Program 


( 


delegate void Del(); 
static void Main(string[] args) 


( 


// The following line causes CS0165 because variable d is ı 
// as an argument before it has been initialized. 
Del d = delegate() { System.Console.WriteLine(d); }; 


//// To resolve the error, initialize d in a separate state 
//Del d = null; 

//// After d is initialized, you can use it as an argument 
//d = delegate() { System.Console.WriteLine(d); }; 

//d(); 





Compiler Error CS0173 


无 法 确定 条 件 表达 式 的 类 型 ， 因 为 “class1”" 和 "class2” 之 间 没 有 隐 式 转换 


当 希 望 不 同类 的 对 象 在 同一 代码 中 使 用 时 ， 类 之 间 的 转换 非常 有 用 。 然 而 ， 在 一 起 
工作 的 两 个 类 不 能 有 相互 转换 和 多 余 转 换 ， 也 不 能 有 隐 式 转换 。 class1 和 class2 
的 类 型 分 别 确定 ， 选 择 更 全 面 的 类 型 作为 条 件 表 达 式 的 类 型 。 有 关 类 型 的 确定 方式 


的 更 多 信息 ， 请 参见 Conditional operator cannot cast implicitly. 


若 要 解决 CS0173， 请 确认 class1 与 class2 之 间 有 且 仅 有 一 个 隐 式 转换 ， 而 不 论 
向 哪个 方向 进行 转换 或 在 哪个 类 中 进行 转换 。 有 关 更 多 信息 ， 请 参见 隆 式 数值 转换 
X (〈C# 参考 ) 和 转换 运算 符 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0173 : 


// CSo173 .cs 
public class C {} 


public class A 


{ 
//// The following code defines an implicit conversion operatoi 
//// type C to type A. 
//public static implicit operator A(C c) 
//{ 
// A a - new A(); 
// a = C; 
// return a; 
//} 
} 


public class MyClass 


public static void F(bool b) 


t 
A a - new A(); 
C c - new C(); 
// The following line causes CS0173 because there is no im[ 
// conversion from a to c or from c to a. 
object o- b? a:c; 
// To resolve the error, you can cast a and c. 
//object o - b ? (object)a : (object)c; 
// Alternatively, you can add a conversion operator from c. 
// class A, or from class A to class C, but not both. 
} 


public static void Main() 


F(true); 





下 面 的 代码 在 Visual Studio 2005 中 不 生成 CS0173， 但 在 更 高 版 本 中 会 生成 
CS0173。 


//cs0173 2.cs 


class M 
{ 
static int Main () 
i H 
int XS 
// The following line causes CS0173 in Visual Studio 2005. 
object o = (X == 0) ? null : null; 
return -1; 
} 





Compiler Error CS0178 


无 效 的 秩 说 明 符 : 应 为 "或 了 

数组 初始 化 的 格式 错误 。 例 如 ， 在 指定 数组 维 数 时 ， 可 以 指定 以 下 内 容 : 
e 中 括号 中 的 数字 。 
e 空 的 中 括号 。 
e 括 在 中 括号 中 的 逗号 。 


有 关 更 多 信息 ， 请 参见 数组 (CH 编程 指南 ) 和 CH 规范 (C# 语言 规范 ) 中 有 关 数 
组 初始 值 设 定 项 的 部 分 。 


下 面 的 示例 生成 CS0178. 


// CS0178.cs 
class MyClass 


public static void Main() 


{ 
int a = new int[5][,][][5; // CS0178 
int[,] b = new int[3,2]; // OK 


int[][] c = new int[10][]; 


c[0] = new int[5][5]; // CS0178 
c[0] = new int[2]; // OK 
c[1] = new int[2]{1, 2}; // OK 


Compiler Error CS0188 


在 给 “this” 对 象 的 所 有 字段 赋值 之 前 ， 无 法 使 用 该 对 象 
构造 画 数 必须 给 struct 中 的 所 有 字段 都 赋值 ， 然 后 才能 调用 struct 中 的 方法 。 


如 果 在 尝试 初始 化 结构 构造 函数 中 的 属性 时 看 到 此 错误 ， 则 解决 方案 将 更 改 此 构造 
函数 参数 以 指定 支持 字段 而 不 指定 该 属性 本 身 。 由 于 自动 实现 的 属性 不 具有 支持 字 
段 ， 因 此 在 任何 情况 下 都 不 可 能 从 构造 画 数 进行 初始 化 ， 从 而 应 在 结构 中 避免 使 用 
自动 实现 的 属性 。 


有 关 更 多 信息 ， 请 参见 使 用 结构 (CH 编程 指南 ) o 
下 面 的 示例 生成 CS0188 : 


// CS0188.cs 
// compile with: /t:library 
namespace MyNamespace 
class MyClass 
struct S 


public int a; 


void MyMethod() 


} 
S(int i) 
// a= i; 
MyMethod(); // CS0188 
} 
public static void Main() 
{ } 
} 
} 
请 参阅 


结构 (CH 编程 指南 ) 
自动 实现 的 属性 (CH 编程 指南 ) 


Compiler Error CS0201 


只 有 assignment, call, increment, decrement 和 new 对 象 表达 式 可 用 作 语 名 


编译 器 在 遇 到 无 效 语句 时 会 生成 错误 。 无 效 语句 是 以 未 表示 以 下 各 项 的 分 号 结尾 的 
任意 行 或 一 系列 行 : 赋值 (=)、 方 法 调用 ()、new、-- 或 ++ 运算 。 有 关 更 多 信息 ， 


请 参见 语句 、 表 达 式 和 运算 符 (C# 编程 指南 ) o 


下 面 的 示例 将 生成 CS0201， 因 为 2* 3 是 表达 式 ， 而 不 是 语句 。 若 要 使 代码 能 够 


编译 ， 请 尝试 将 表达 式 的 值 赋 给 变量 。 


// CS0201.cs 
public class MainClass 


public static void Main() 

{ 
2 3 // CS0201 
// Try the following line instead. 
£L Gm 1-025 27 


下 面 的 示例 将 生成 CS0201, B7 checked 本 身 并 不 是 语句， 即使 已 通过 


对 其 进行 了 参数 化 。 


// CS0201_b.cs 
// compile with: /target:library 
public class MyList<T> 


{ 
public void Add(T x) 
{ 
int i = 0; 
if ( (object)x -- null) 
{ 
checked(i++); // CS0201 
// OK 
checked { 
i++; 
} 
} 
} 
} 


增 操 作 
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C£ Compiler Errors 


Compiler Error CS0201 1208 


Compiler Error CS0229 


“member1” 和 “member2” 之 间 有 具有 二 义 性 


不 同 接口 的 成 员 具 有 相同 的 名 称 。 如 果 要 保留 相同 的 名 称 ， 则 必须 限定 这 些 名 称 。 
有 关 更 多 信息 ， 请 参见 接口 (CH 编程 指南 ) 。 


MN = 
Ef TERR 


B nu 此 二 义 性 可 以 通过 使 用 using 别名 向 标识 符 提供 明确 的 前 级 来 
EA. 


下 面 的 示例 生成 CS0229 : 


// 05022065 


interface IList 


: int Count 
{ 
get; 
set; 
} 
void Counter (); 
} 


interface Icounter 


double Count 


{ 
get; 
set; 


} 
interface IListCounter : IList , Icounter {} 


class MyClass 


{ 

void Test(IListCounter x) 

{ 
x.Count = 1; // CS0229 
// Try one of the following lines instead: 
// ((IList)x).Count = 1; 
// or 
// ((Icounter)x).Count = 1; 

} 


public static void Main() {} 


Compiler Error CS0233 


“identifier 没 有 预定 义 大 小 ， 因 此 sizeof 只 能 用 于 不 安全 的 上 下 文中 (请 考虑 使 用 
System.Runtime.InteropServices.Marshal.SizeOf) 


sizeof 运算 符 只 能 用 于 为 编译 时 常数 的 类 型 。 如 果 您 遇 到 此 错误 ， 请 确保 在 编译 时 
可 以 确定 标识 符 的 大 小 。 如 果 不 能 确定 ， 则 用 SizeOf 代 蔡 sizeof, 


下 面 的 示例 生成 CS0233 : 


// CS0233.cs 
using System; 
using System.Runtime.InteropServices; 


[StructLayout(LayoutKind.Sequential)] 
public struct S 


public int a; 


} 
public class MyClass 


public static void Main() 

{ 
S myS = new S(); 
Console.WriteLine(sizeof(S)); // CS0233 
// Try the following line instead: 
// Console.WriteLine(Marshal.SizeOf(myS)); 


Compiler Error CS0234 


$544 Z? ig “namespace” Fh Tz (E 3: Eis op d ze ig f name" (是 否 缺 少 程序 集 引 
FH?) 


应 为 某 个 类 型 。 此 错误 可 能 的 原因 包括 : 
。 在 编译 中 未 引用 包含 某 个 类 型 定义 的 程序 集 ; 请 使 用 /reference (导入 元 数 
据 ) 指定 程序 集 
e 将 某 个 变量 名 传递 给 了 typeof 运算 符 。 
e 您 尝试 引用 的 程序 集 不 属于 目标 .NET Framework 配置 文件 的 一 部 分 。 有 关 更 


多 信息 ， 请 参见 .NET Framework 目标 错误 疑难 解答 。 


如 果 在 将 代码 从 一 台 开 发 计算 机 转移 到 另 一 台 开 发 计算 机 后 看 到 此 错误 ， 请 确保 新 
计算 机 上 的 项 目 具 有 正确 的 引用 ， 并 且 程 序 集 的 版 本 与 旧 计 算 机 上 的 程序 集 版 本 相 
同 。 您 也 可 以 使 用 对 象 浏览 器 来 检查 程序 集 ， 并 验证 该 程序 集 是 否 包含 其 预期 要 包 


含 的 类 型 。 


下 面 的 示例 生成 CS0234 : 


// CS0234.cs 
public class C 


public static void Main() 


System.DateTime x - new System.DateTim(); // CS0234 
// try the following line instead 
// System.DateTime x - new System.DateTime(); 
} 
} 


Compiler Error CS0246 


未 能 找到 类 型 或 命名 空间 名 称 “"type/namespace” (ZAR using 指 今 或 程序 集 引 
HH?) 


未 找到 程序 中 使 用 的 类 型 或 命名 空间 。 可 能 忘 了 引用 (reference) 包含 该 类 型 的 程 
序 集 ， 或 者 可 能 未 用 using 指 邻 正确 地 限定 其 用 法 。 


以 下 情况 会 导致 编译 器 错误 CS0246。 


e 类 型 或 命名 空间 的 名 称 拼 写 是 否 有 误 ?没有 正确 的 名 称 ， 编 译 器 就 无 法 找到 类 
型 或 命名 空间 的 定义 。 这 通常 是 由 于 类 型 名 称 中 使 用 的 大 小 写 形式 不 正确 。 例 
如 ，Dataset ds; 会 生成 CS0246， 因 为 Dataset 中 的 s 必须 大 写 。 


e 如 果 错 误 的 原因 在 于 命名 空间 名 称 ， 您 是 否 添加 了 对 于 包含 该 命名 空间 的 程序 
集 的 引用 (reference)? 例如 ， 您 的 代码 可 能 包含 指令 using Accessibility。 但 
是 ， 如 果 项 目 不 引 用 程序 集 Accessibility.dll， 则 会 报告 错误 CS0246, 


e 如 果 错 误 的 原因 在 于 类 型 名 称 ， 您 是 否 包 括 了 正确 的 using 指令 ， 或 是 否 已 完 
全 限定 该 类 型 的 名 称 ? 考 虑 下 列 声明 : DataSet ds。 若 要 使 用 DataSet 类 型 ， 
需要 具备 两 个 条 件 。 第 一 ， 需 要 一 个 对 包含 DataSet 类 型 定义 的 程序 集 的 引 
用 。 第 二 ， 需 要 对 DataSet 所 在 的 命名 空间 使 用 using 指令 。 例 如 ， 由 于 
DataSet 位 于 System.Data 命名 空间 中 ， 所 以 需要 在 代码 的 开头 使 用 以 下 指 
4 : using System.Data. 


using 指令 不 是 必需 的 。 但 如 果 省 略 该 指令 ， 则 在 引用 DataSet 类 型 时 必须 对 
它 进行 完全 限定 。 完 全 限定 意味 着 每 次 在 代码 中 引用 类 型 时 都 要 同时 指定 命名 
空间 和 类 型 。 如 果 在 上 一 示例 中 省 略 using 指令 ， 则 必须 编写 
System.Data.DataSet ds 来 声明 ds 而 不 是 DataSet ds。 


e 您 是 否 在 需要 类 型 的 地 方 使 用 了 变量 或 其 他 某 种 语言 元 素 ? 例如， 在 is 语句 
中 ， 如 果 您 使 用 Type 对 象 而 不 是 实际 的 类 型 ， 将 会 出 现 错误 CS0246。 

e 是 否 使 用 了 using 别名 指令 ， 但 没有 完全 限定 类 型 名 称 ? using 别名 指令 不 使 
用 源 代 码 文 件 中 的 using 指令 来 解析 类 型 。 下 面 的 示例 生成 CS0246， 因 为 类 
型 List<int> 未 完全 限定 。 System.Collections.Generic 的 using 指令 无 法 避免 
该 错误 。 


using System.Collections.Generic; 


// The following declaration generates CS0246. 
using myAliasName - List&lt;int&gt;; 


// To avoid the error, fully qualify List. 
using myAliasName2 - System.Collections.Generic.List&lt;int&gt; 


E = — ERR 








下 面 的 示例 生成 CS0246， 因 为 缺少 必要 的 using 指 今 。 


// CS0246.cs 
//using System.Diagnostics; 


public class MyClass 
1 
// The following line causes CS0246\. To fix the error, uncomme 
// the using directive for the namespace for this attribute, 
// System.Diagnostics. 
[Conditional("A")] 
public void Test() 
t 
} 


public static void Main() 





下 面 的 示例 会 引发 CS0246， 因 为 在 需要 实际 类 型 的 位 置 使 用 了 类 型 为 Type 的 对 
象 。 


// CS0246b.cs 
using System; 


class ExampleClass 
{ 
public bool supports(object o, Type t) 
{ 
// The following line causes CS0246\. You must use an 
// actual type, such as ExampleClass, String, or Type. 
if (o is t) 
{ 


} 


return false; 


return true; 


} 


class Program 


{ 
public static void Main() 
{ 
ExampleClass myC = new ExampleClass(); 
myC.supports(myC, myC.GetType()); 
} 


Compiler Error CS0260 


类 型 “type” 的 声明 上 缺少 分 部 修饰 符 ; 存在 此 类 型 的 其 他 分 部 声明 


此 错误 指示 您 声明 具有 相同 名 称 的 多 个 类 。 此 外 ， 至 少 一 个 ， 但 并 非 全 部 声明 包含 
一 个 partial 修饰 符 。 如 果 您 想 在 若干 部 分 中 定义 一 个 类 ， 通过 使 用 关键 字 
partial， 必 须 声 明 每 个 部 分 。 


如 果 您 声明 一 个 新 类 碰巧 与 同一 命名 空间 中 的 其 他 位 置 声 明 的 分 部 类 具有 相同 的 名 
称 ， 则 也 会 发 生 此 错误 。 


下 面 的 示例 生成 CS0260 : 


// CS0260.cs 
// You must mark both parts of the definition of class C 
// by using the partial keyword. 


// The following line causes CS0260*. To resolve the error, add 
// the 'partial' keyword to the declaration. 
class C 


{ 
} 


partial class C 


请 参阅 


分 部 类 和 方法 (C# 编程 指南 ) 


Compiler Error CS0266 


FA X typet Ri A “type? FE EMH (是 否 缺 少 强制 转换 ? ) 


当代 码 党 试 在 无 法 进行 隐 式 转换 的 两 个 类 型 上 党 试 转换 时 ， 此 错误 发 生 。 有 关 详 细 
信息 ， 请 参阅 强制 转换 和 类 型 转换 (CH 编程 指南 ) o 


下 面 的 代码 演示 生成 CS0266 的 示例 。 


«| 


// CS0266.cs 
class MyClass 


{ 


} 


public static void Main() 


1 


// You cannot implicitly convert a double to an integer. 
double d - 3.2; 


// The following line causes compiler error CS0266. 
int i1 = d; 
// However, you can resolve the error by using an explicit 


int i2 = (int)d; 


// You cannot implicitly convert an object to a class type 
object obj = "MyString"; 


// The following assignment statement causes error CS0266. 
MyClass myClass = obj; 


// You can resolve the error by using an explicit conversic 
MyClass c = ( MyClass )obj; 


// You cannot implicitly convert a base class object to a ¢ 
MyClass mc = new MyClass(); 
DerivedClass dc = new DerivedClass(); 


// The following line causes compiler error CS0266. 
dc - mc; 


// You can resolve the error by using an explicit conversi 
dc - (DerivedClass)mc; 


class DerivedClass : MyClass 


{ 
} 








Compiler Error CS0269 


使 用 了 未 赋值 的 out 22: parameter" 


编译 器 未 能 验证 在 使 用 out 参数 之 前 是 否 已 给 它 赋值 ， 它 的 值 在 赋值 时 可 能 未 定 
义 。 在 访问 值 之 前 ， 请 确保 为 调用 的 方法 中 的 out 参数 赋值 。 如 果 您 需要 使 用 传人 
的 变量 的 值 ， 请 改 用 ref 参数 。 有 关 更 多 信息 ， 请 参见 传递 参数 (CH 编程 指南 ) o 


下 面 的 示例 生成 CS0269 : 


// CS0269.cs 
class C 
{ 
public static void F(out int i) 
// One way to resolve the error is to use a ref parameter inst: 
// of an out parameter. 
//public static void F(ref int i) 
{ 
// The following line causes a compiler error because no vé 
// has been assigned to i. 
int k = i; // CS0269 
i = 1; 
// The error does not occur if the order of the two previot 
// lines is reversed. 


} 


public static void Main() 

{ 
int myInt = 1; 
F(out myInt); 
// If the declaration of method F is changed to require a ! 
// parameter, ref must be specified in the call as well. 
//F(ref myInt); 





如 果 变 量 的 初始 化 发 生 在 try 块 中 ， 则 也 会 出 现 此 错误 ， 因 为 编译 器 无 法 验证 try 3 
是 否 可 以 成 功 执行 : 


// CS0269b.cs 


class C 
{ 
public static void F(out int i) 
{ 
try 
{ 
// Assignment occurs, but compiler can't verify it 
i = 1; 
} 
catch 
{ 
} 
int k = i; // CS0269 
T= 
} 
public static void Main() 
{ 
int myInt; 
F(out myInt); 
} 


Compiler Error CS0270 


不 能 在 变量 声明 中 指定 数组 大 小 (请 尝试 使 用 “new" 表 达 式 初始 化 ) 


将 大 小 指定 为 数组 声明 的 一 部 分 时 会 发 生 此 错误 。 若 要 解决 此 错误 ， 请 使 用 new 运 
算 符 表 达 式 。 


下 面 的 示例 生成 CS0270 : 


// CS0270.cs 
// compile with: /t:module 


public class Test 
int[10] a; // CS0270 


// To resolve, use the following line instead: 
// int[] a = new int[10]; 


Compiler Error CS0304 


变量 类 型 “type” 没 有 new() 约束 ， 因 此 无 法 创建 该 类 型 的 实例 
如 果实 现 泛 型 类 ， 并 且 需 要 使 用 new 关键 字 来 创建 为 类 型 参数 T 提供 的 任何 类 型 
的 新 实例 ， 则 必须 在 类 声明 中 将 new() 约束 应 用 于 T， 如 下 面 的 示例 所 示 。 


class C«T» where T : new() 


new() 约束 将 通过 确保 为 下 提供 的 任何 具体 类 型 都 具有 默认 值 (TARER) 
来 实施 类 型 安全 。 如 果 您 在 T 未 指定 new() 约束 时 党 试 在 类 的 正文 中 使 用 new 运 
算 符 创建 类 型 参数 T 的 实例 ， 将 出 现 CS0304。 在 客户 端 ， 如 果 代 码 党 试 使 用 没有 
默认 构造 范 数 的 类 型 实例 化 泛 型 类 ， 则 该 代码 将 生成 Compiler Error CS0310。 


下 面 的 示例 会 生成 CS0304。 


// CS0304.cs 
// Compile with: /target:library. 
class C<T> 


// The following line generates CS0304. 
T t - new T(); 


该 类 的 方法 中 也 不 允许 使 用 new 运算 符 。 


// Compile with: /target:library. 
class C<T> 


public void ExampleMethod() 


// The following line generates CS0304. 
T t - new T(); 


若 要 避免 该 错误 ， 请 使 用 new() 约束 声明 类 ， 如 下 面 的 示例 所 示 。 


// Compile with: /target:library. 
class C«T» where T : new() 


{ 
T t = new T(); 
public void ExampleMethod( ) 


T t = new T(); 


C# Compiler Errors 


Compiler Error CS0310 

ix l"typename" i f ERA SE BC BAIS WAFER KAY, -PBEFB I EZERU X 
型 或 方法 “generic" 中 的 参数 "parameter 

泛 型 类 型 或 方法 在 它 的 where 子 句 中 定义 了 一 个 新 约束 ， 要 求 任何 类 型 均 必 须 具 有 
公共 的 无 参数 构造 画 数 才能 用 作 该 泛 型 类 型 或 方法 的 类 型 参数 。 若 要 避免 此 错误 ， 
请 确保 类 型 具有 正确 的 构造 画 数 ， 或 者 修改 泛 型 类 型 或 方法 的 约束 子 句 。 

下 面 的 示例 生成 CS0310 : 


// CS0310 .cs 
using System; 


class G«T» where T : new() 
lj St 
public G() 
f 


t - new T(); 
Console.WriteLine(t); 


j 
j 
class B 
{ 
private B() { } 
// Try this instead: 
// public B() { } 
} 


class CMain 
public static void Main() 


G<B> g = new G<B>(); // CS0310 
Console.WriteLine(g.ToString()); 


Compiler Error CS0311 


不 能 将 类 型 “type1” 用 作 泛 型 类 型 或 '<name> 方 法 中 的 类 型 参数 “T”。 没 有 
从 “type1” 到 “type2” 的 隐 式 引用 转换 。 


在 将 某 一 约束 应 用 于 泛 型 类 型 参数 时 ， 必 须 存 在 从 具体 参数 到 该 约束 类 型 的 隐 式 标 
识 或 引用 转换 。 


更 正 此 错误 
1. 更 改 要 在 创建 类 时 使 用 的 参数 。 


2. 如 果 您 拥有 类 ， 则 可 移 除 约束 或 执行 某 一 操作 以 启用 隐 式 引用 或 标识 转换 。 例 
如 ， 可 以 使 第 二 个 类 型 从 第 一 个 类 型 继承 。 


// cs0311.cs 

class B{} 

class C() 

class Test«T» where T : C 


{ } 


class Program 


{ 


static void Main() 


{ 
} 


Test<B> test = new Test<B>(); //CS0311 
如 果 在 尝试 使 用 值 类 型 参数 时 发 生 此 错误 ， 您 会 发 现 隐 式 数 值 转换 (例如 ， 从 
short 到 int 的 转换 ) 不 满足 泛 型 类 型 参数 的 约束 。 
请 参阅 


类 型 参数 的 约束 (CH 编程 指南 ) 


Compiler Error CS0413 


由 于 类 型 参数 “type parameter 既 没有 类 类 型 约束 ， 也 没有 “class" 约 束 ， 因 此 不 能 
与 "as" 运 算 符 一 起 使 用 

如 果 某 个 泛 型 类 型 使 用 了 as 运算 符 ， 但 该 泛 型 类 型 不 具有 类 类 型 约束 ， 则 发 生 此 
错误 。 as 运算 符 只 人 允许 用 于 引用 类 型 ， 因 此 必须 约束 类 型 参数 以 保证 它 不 是 值 类 
型 。 要 避免 此 错误 ， 请 使 用 类 类 型 约束 或 引用 类 型 约束 。 

这 是 因为 as 运算 符 能 够 返回 null ( 它 不 可 能 是 值 类 型 的 值 ) ， 并 且 类 型 参数 必须 
被 视 为 值 类 型 ， 除 非 它 是 类 类 型 约束 或 引用 类 型 约束 。 


下 面 的 示例 生成 CS0413。 


// CS0413.cs 

// compile with: /target:library 
class A {} 

class B : A {} 


class CMain 


{ 

A a = null; 

public void G<T>() 

{ 
a = new A(); 
System.Console.WriteLine (a as T); // CS0413 

} 

// OK 

public void H<T>() where T : A 

{ 
a = new A(); 
System.Console.WriteLine (a as T); 

} 


} 


Compiler Error CS0417 


"identifier" : 创建 变量 类 型 的 实例 时 无 法 提供 参数 


如 果 对 类 型 参数 上 的 new 的 调用 带 有 参数 ， 则 会 发 生 此 错误 。 通 过 在 未 知 参数 类 型 
上 的 使 用 new， 可 以 被 调用 的 唯一 构造 画 数 是 不 带 参 数 的 。 如 果 需 要 调用 另 一 个 构 
造 男 数 ， 请 考虑 使 用 类 类 型 约束 或 接口 约束 。 


下 面 的 示例 生成 CS0417 : 


// CS0417 
class ExampleClass<T> where T : new() 


{ 
// The following line causes CS0417. 


T instance1 = new T(1); 


// The following line doesn't cause the error. 
T instance2 = new T(); 


类 型 参数 的 约束 (CH 编程 指南 ) 


Compiler Error CS0433 


类 型 TypeName1 同时 存在 于 TypeName2 和 TypeName3 中 。 


在 应 用 程序 中 引用 的 两 个 不 同 的 程序 集 包 含 相同 的 命名 空间 和 类 型 ， 这 会 产生 混 
Blo 


若 要 解决 此 错误 ， 请 使 用 reference (C# Compiler Options) 编译 器 选项 的 别名 功 
能 ， 或 者 不 引用 您 的 程序 集 。 


此 代码 用 蚊 义 类 型 的 第 一 个 副本 创建 DLL. 


// CS0433 1.cs 
// compile with: /target:library 
namespace TypeBindConflicts 


public class AggPubImpAggPubImp {} 
} 


此 代码 用 上 岐 义 类 型 的 第 二 个 副本 创建 DLL. 


// CS0433 2.cs 
// compile with: /target:library 
namespace TypeBindConflicts 


public class AggPubImpAggPubImp {} 
} 


下 面 的 示例 生成 CS0433。 


// CS0433 3.cs 

// compile with: /reference:cs0433 1.dll /reference:cs0433 2.dll 
using TypeBindConflicts; 

public class Test 


public static void Main() 


AggPubImpAggPublImp n6 = new AggPubImpAggPubImp(); // CS043: 
} 
} 


| 
下 面 的 示例 演示 如 何 使 用 /reference 编译 器 选项 的 别名 功能 来 解决 此 CS0433 错 


va 
IRo 


// CS0433 4.cs 

// compile with: /reference:cs0433 1.dll /reference:TypeBindConfli« 
using TypeBindConflicts; 

public class Test 


t 
public static void Main() 
{ 
AggPubImpAggPubImp n6 = new AggPubImpAggPubImp(); 
j 
j 








Compiler Error CS0445 


无 法 修改 取消 装 箱 转 换 的 结果 


取消 装 箱 转换 的 结果 是 一 个 临时 变量 。 编 译 器 禁止 您 修改 这 样 的 变量 ， 因 为 当 临 时 
变量 消失 时 ， 任 何 修改 也 随 之 消失 。 若 要 修复 此 错误 ， 声 明 新 的 值 类 型 变量 来 存储 
中 间 表 达 式 ， 并 将 取消 装 箱 的 转换 的 结果 赋 给 该 新 变量 。 


下 面 的 代码 生成 CS0455。 





// CS0445.CS 
class UnboxingTest 


public static void Main() 


{ . 
Point ae 
p.x = 
p.y = 
object re - p; 
// The following line generates CS0445, because the result 
// of unboxing obj is a temporary variable. 
((Point)obj).x = 2; 
// The following lines resolve the error. 
// Store the result of the unboxing conversion in p2. 
Point p2; 
- (Point)obj; 
// Then you can modify the unboxed value. 
p2.x = 2; 
} 


} 


struct Point 


public int x, y; 
} 


p Bil 


Compiler Error CS0446 


Foreach 不 能 在 “方法 或 委托 ”上 运行 。 是 否 希 望 调用 “方法 或 委托 ”? 


指定 一 个 没有 括号 的 方法 或 指定 一 个 在 foreach 语句 部 分 (通常 放 入 集合 类 ) RA 
括号 的 匿名 方法 会 导致 此 错误 。 请 注意 ， 如 果 方 法 返回 一 个 集合 类 ， 则 将 该 方法 调 
用 放 在 那个 位 置 是 有 效 的 ， 尽 管 这 不 常见 。 


下 面 的 代码 将 生成 CS0446。 


// CS0446.cs 
using System; 
class Tester 


static void Main() 


int[] intArray - new int[5]; 
foreach (int i in M) ( ) // CS0446 


j 
static void M() { } 


Compiler Error CS0504 


常数 “variable” 无 法 标记 为 static 


如 果 变 量 是 const， 它 也 就 是 static。 如 果 需 要 一 个 既是 const 又 是 static HF 
量 ， 只 需 将 该 变量 声明 为 const; 如 果 需 要 的 只 是 static 交 量 ， 只 需 将 其 标记 为 
static, 


下 面 的 示例 生成 CS0504 : 


// CS0504.cs 
namespace x 


{ 
abstract public class clx 
{ 
static const int i = 0; // CS0504, cannot be both static ar 
abstract public void f(); 
} 





4a iF a3 44 i CS0507 


"function 1" : 当 重 写 “access” 继 承 成 员 “function2” 时 ， 无 法 更 改 访问 修 饰 符 
尝试 在 方法 重 写 中 更 改 访问 规范 。 


示例 
下 面 的 示例 生成 CS0507。 


// CS0507.cs 
abstract public class clx 


virtual protected void f() {} 
j 


public class cly : clx 


public override void f() {} // CS0507 
public static void Main() {} 


j 


类 尝试 重 写 在 引用 的 元 数据 中 定义 的 标记 为 protected internal 的 方法 时 ， 也 会 发 
生 CS0507。 在 这 种 情况 下 ， 重 写 方法 应 标记 为 protected, 


// CS0507_b ,cs 
// compile with: /target:library 
abstract public class clx 


i 
} 


virtual protected internal void f() {} 


下 面 的 示例 生成 CS0507。 


// CS0507 c.cs 

// compile with: /reference:cs0507 b.dll 

public class cly : clx 

{ 
protected internal override void f() {} // CS0507 
// try the following line instead 
// protected override void f() {} // OK 


public static void Main() {} 
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Compiler Error CS0518 


预定 义 的 类 型 “type” 未 定义 或 未 导入 


引起 该 问题 的 主要 原因 是 项 目 没有 导入 mscorlib.dll， 该 文件 定义 整个 System 命名 
空间 。 这 可 能 由 以 下 原因 之 一 导致 : 


e 指定 了 命令 行 编译 器 的 /nostdlib 选项 。/nostdlib 选项 将 禁止 导入 
mscorlib.dll。 如 果 想 要 定义 或 创建 用 户 特定 的 System 命名 空间 ， 请 使 用 此 选 


项 。 
e 引用 了 错误 的 mscorlib.dll。 
e Visual Studio .NET 或 .NET Framework 公共 语言 运行 时 安装 存在 损坏 。 
e 早期 安装 所 剩 的 组 件 与 最 新 安装 的 其 余 组 件 不 兼容 。 
要 解决 此 问题 ， 请 采用 以 下 操作 之 一 : 
。 不 指定 命令 行 编译 器 的 /nostdlib 选项 。 
e 确保 项 目 引 用 正确 的 mscorlib.dll。 


e 重新 安装 NET Framework 公共 语言 运行 时 〈 若 以 上 解决 方案 均 未 能 解决 此 问 
题 ) 。 


Compiler Error CS0523 


“struct1” 类 型 的 结构 成 员 "struct2 field" 在 结构 布局 中 导致 循环 


两 个 结构 的 定义 包含 递归 引用 。 更 改 struct 定义 以 便 每 个 结构 都 不 会 在 另 一 结构 上 
定义 自身 。 此 限制 你 适 用 于 结构 ， 因 为 结构 是 值 类 型 。 如 果 使 用 递归 引用 ， 请 将 类 
型 声明 为 类 。 


下 面 的 示例 生成 CS0523 : 


// CS0523 .cs 
// compile with: /target:library 
struct RecursiveLayoutStruct1i 


public RecursiveLayoutStruct2 field; 


j 


struct RecursiveLayoutStruct2 


public RecursiveLayoutStructi field; // 650523 
} 


Compiler Error CS0545 


"function" : JABS, [NX "property R A AESH get 访问 器 


尝试 定义 属性 访问 器 的 重 宇 ， 而 此 时 基 类 没有 这 样 的 定义 可 供 重 宇 。 可 以 通过 下 面 
的 方法 解决 该 错误 : 


e. 在 基 类 中 添加 set 访问 器 。 
e. 从 派生 类 中 移 除 set 访问 器 。 
。 通过 在 派生 类 的 属性 中 添加 new 关键 字 来 隐藏 基 类 属性 。 
e 生成 基 类 属性 virtual。 
有 关 更 多 信息 ， 请 参见 使 用 属性 (CH 编程 指南 ) o 
下 面 的 示例 生成 CS0545。 


// CS0545.cs 

// compile with: /target:library 
// CS0545 

public class a 


public virtual int i 
set {} 


// Uncomment the following line to resolve. 
// get ( return 0; ) 


} 
} 
public class b : a 
t 


public override int i 
1 
get ( return 0; ) 
set {} // OK 
} 
} 


Compiler Error CS0552 


"conversion routine" : 与 接口 之 间 的 用 户 定义 转换 


不 能 创建 用 户 定义 的 接口 转换 。 如 果 需 要 转换 例 程 ， 则 使 接口 成 为 类 来 解决 该 错 
误 ， 或 者 从 接口 派生 类 。 


下 面 的 示例 生成 CS0552 : 


// CS0552 .cs 
public interface ii 


} 
public class a 


// delete the routine to resolve CS0552 
public static implicit operator ii(a aa) // CS0552 


{ 
return new ii(); 
j 
public static void Main() 
j 


Compiler Error CS0563 


二 元 运算 符 的 参数 之 一 必须 是 包含 类 型 
运算 符 重 载 的 方法 声明 必须 遵循 一 定 的 准则 。 
下 面 的 示例 生成 CS0563 : 


// CS0563 .cs 
public class iii 


í 


public static implicit operator int(iii x) 


{ 


return 0; 


public static implicit operator iii(int x) 


( 


return null; 


public static int operator +(int aa, int bb) // CS0563 
// Use the following line instead: 

// public static int operator +(int aa, iii bb) 

{ 


return 0; 


public static void Main() 


{ 
} 


Compiler Error CS0570 


属性 、 索 引 器 或 事件 name” 不 受 该 语言 支持 ; 请 党 试 直 接 调用 访问 器 方法 "namey 


当 使 用 由 另 一 编译 器 生成 的 导入 元 数据 时 发 生 此 错误 。 您 的 代码 尝试 使 用 编译 器 无 
法 处 理 的 类 成 员 。 


下 面 的 C++ 程序 使 用 了 一 种 其 他 话 言 不 能 使 用 的 特性 RequiredAttributeAttribute。 


// CPP0570.cpp 
// compile with: /clr /LD 


using namespace System; 
using namespace System::Runtime::CompilerServices; 


namespace CS0570 Server ( 
[RequiredAttributeAttribute(Int32::typeid)] 
public ref struct Scenarioi1 { 
int intVar; 


H 


public ref struct CS0570Class ( 
Scenario1 ^ sc1 field; 


property virtual Scenarioi ^ sci prop { 
Scenarioi ^ get() ( return sci field; } 


j 


Scenarioi ^ sci method() ( return sca field; } 
3 
3 


下 面 的 示例 生成 CS0570. 


// CS0570.cs 

// compile with: /reference:CPP0570.d11 
using System; 

using CS0570 Server; 


public class C ( 
public static int Main() { 
CS0570Class r - new CS0570Class(); 
r.sci field = null; // CS0570 
object o = r.sci prop; // CS0570 
r.sci_method(); // CS0570 
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Compiler Error CS0571 


"function" : 无 法 显 式 调用 运算 符 或 访问 器 


某 些 运算 符 具 有 内 部 名 称 。 例 如 ，op_Increment 是 ++ 运算 符 的 内 部 名 称 。 不 应 
使 用 或 显 式 调用 这 样 的 方法 名 称 。 


下 面 的 示例 生成 CS0571 : 





// CS0571.cs 
public class MyClass 


{ 
public static MyClass operator ++ (MyClass c) 
{ 
return null; 
} 
public static int prop 
{ 
get 
{ 
return 1; 
} 
set 
{ 
} 
} 
public static void Main() 
{ 
op_Increment (null); // CS0571 
// use the increment operator as follows 
// MyClass x = new MyClass(); 
UI FF 
set prop(1); // CS0571 
// try the following line instead 
// prop = 1; 
} 


Compiler Error CS0579 


重复 “attribute” 特 性 


不 可 能 多 次 指定 相同 的 特性 ， 除 非特 性 在 其 AttributeUsage 中 指定 
AllowMultiple-true, 


下 面 的 示例 会 产生 CS0579。 


// CS0579 .cs 

using System; 

public class MyAttribute : Attribute 
{ 

} 


[AttributeUsage(AttributeTargets.All,AllowMultiple=true)] 
public class MyAttribute2 : Attribute 


{ 
} 
public class z 
{ 
[MyAttribute, MyAttribute] // CS0579 
public void zz() 
{ 
} 


[MyAttribute2, MyAttribute2]  // OK 
public void zzz() 

{ 

j 


public static void Main() 


{ 
} 


Compiler Error CS0592 


特性 “attribute” 对 此 声明 类 型 无 效 。 它 只 对 “type” 声 明 有 效 。 


在 定义 特性 时 ， 可 通过 指定 AttributeTargets 值 来 定义 可 将 该 特性 应 用 于 什么 构 
造 。 在 下 面 的 示例 中 ，MyAttribute 特性 只 能 点 用 于 接口 ， 因 为 AttributeUsage 特 
性 指定 AttributeTargets.lterface。 之 所 以 会 生成 错误 ， 原 因 是 该 特性 应 用 于 类 (类 
A) 。 


下 面 的 示例 生成 CS0592 : 
// CS0592 .cs 
using System; 


[AttributeUsage(AttributeTargets.Interface)] 
public class MyAttribute : Attribute 

{ 

} 


[MyAttribute] 
// Generates CS0592 because MyAttribute is not valid for a class. 
public class A 


public static void Main() 


特性 (C# 和 Visual Basic) 


Compiler Error CS0616 


“class" 不 是 特性 类 
尝试 在 特性 块 中 使 用 非特 性 类 。 所 有 特性 类 型 都 必须 从 System.Attribute 继承 。 
下 面 的 示例 生成 CS0616。 


// CS0616.cs 

// compile with: /target:library 
[CMyClass(i = 5)]  // CS0616 
public class CMyClass {} 


下 面 的 示例 显示 您 可 以 如 何 定义 特性 : 


// CreateAttrib.cs 
// compile with: /target:library 
using System; 


[AttributeUsage(AttributeTargets.Class|AttributeTargets.Interface). 
public class MyAttr : Attribute 
{ 

public int Name = 0; 

public int Count = 0; 


public MyAttr (int iCount, int sName) 
{ 


Count = iCount; 
Name = sName; 
} 
} 


[MyAttr(5, 50)] 
class Classi {} 


[MyAttr(6, 60)] 
interface Interfacei {} 


Compiler Error CS0650 
错误 的 数组 声明 符 : 若 要 声明 托管 数组 ， 秩 说 明 符 应 位 于 变量 的 标识 符 之 前 。 若 要 
声明 固定 大 小 缓冲 区 字段 ， 应 在 字段 类 型 之 前 使 用 fixed 关键 字 。 


数组 未 正确 声明 。 在 C# 中 ， 与 C 和 C++ 中 不 同 ， 方 括号 放 在 类 型 (而 不 是 变量 
名 ) 后 面 。 并 且 ， 请 注意 固定 大 小 缓冲 区 的 语法 与 数组 的 语法 不 同 。 


下 面 的 代码 示例 生成 CS0650。 


// CS0650.cs 
public class MyClass 


( 


public static void Main() 


{ 
// Generates CS0650N. Incorrect array declaration syntax: 
int myarray[2]; 


// Correct declaration. 
int[] myarray2; 


// Declaration and initialization in one statement 
int[] myArray3- new int[2] {1,2} 


// Access an array element. 
myarray3[0] = 0; 


下 面 的 示例 演示 如 何在 创建 固定 大 小 缓冲 区 时 使 用 fixed 关键 字 : 


// This code must appear in an unsafe block. 
public struct MyArray 


public fixed char pathName[128]; 


请 参阅 

固定 大 小 的 缓冲 区 (CH 编程 指南 ) 
fixed 语句 (CH 2) 
数组 (CH 编程 指南 ) 


Compiler Error CS0686 


访问 符 “accessor" 无 法 实现 类 型 “type” 的 接口 成 员 “member”。 使 用 显 式 接口 实现 。 


提示 : 当 实 现 一 个 接口 时 ， 如 果 其 中 包含 的 方法 名 称 与 属性 或 事件 关联 的 自动 生成 
的 方法 相 冲 突 ， 会 出 现 此 错误 。 属 性 的 get/set 方法 生成 为 get. property 和 
set_property， 事 件 的 add/remove 方法 生成 为 add event 和 remove_event。 如 果 
接口 包含 其 中 的 任何 一 个 方法 ， 则 发 生 冲突 。 要 避免 此 错误 ， 请 使 用 显 式 接口 实现 
来 实现 这 些 方 法 。 要 这 样 做 ， 请 将 函数 指定 为 : 


Interface.get property() ( /* */ } 
Interface.set property() ( /* */ } 


以 下 示例 生成 CS0686 : 


// CS0686.cs 
interface I 


int get P(); 


Glasses emi 


public int P 


x 
get ( return 1; } // CS0686 


} 
// But the following is valid: 
class D : I 


{ 
int I.get P() { return 1; } 
public static void Main() {} 


声明 事件 时 也 会 发 生 此 错误 。 事 件 结构 自动 生成 addevent 和 removeevent 方法 ， 
这 可 能 和 接口 中 的 同名 方法 相 冲 突 ， 如 下 示例 所 示 : 


// CS0686b.cs 
using System; 


interface I 


{ 
void add OnMyEvent(EventHandler e); 
} 
class ¢ cT 
{ 
public event EventHandler OnMyEvent 
add { } // CS0686 
remove { } 
} 
} 


// Correct (using explicit interface implementation): 
class D : I 
{ 

void I.add OnMyEvent(EventHandler e) {} 

public static void Main() {} 


Compiler Error CS0702 


约束 不 能 是 特殊 类 “identifier” 


下 面 的 类 型 不 能 用 作 约 束 : System.Object、System.Array、System.Delegate、 
System.Enum 和 System.ValueType。 


下 面 的 示例 生成 CS0702 : 


// CS0702.cs 
class C<T> where T : System.Array // CS0702 


{ 
} 


请 参阅 
开 


类 型 参数 的 约束 (CH 编程 指南 ) 


4a 1% a 5% 1% CS0703 
可 访问 性 不 一 致 : 约束 类 型 “identifier" 的 可 访问 性 比 "identifier" 低 。 


一 个 约束 不 能 强制 泛 型 参数 比 泛 型 类 本 身 的 可 访问 性 低 。 在 下 面 的 示例 中 ， 虽 然 泛 
型 类 CC<T> 被 声明 为 public， 但 约束 党 试 强制 下 实现 内 部 接口 。 即使 允许 这 样 
做 ， 也 只 有 具有 内 部 访问 的 客户 端 才 能 为 该 类 创建 参数 ， 因 此 实际 上 只 有 具有 内 部 
访问 的 客户 端 才能 使 用 该 类 。 

为 消除 此 错误 ， 请 确保 泛 型 类 的 访问 级 别 的 限制 性 不 低 于 界限 中 出 现 的 任何 类 或 接 


o 


下 面 的 示例 生成 CS0703 : 


// CS0703.cs 
internal interface I {} 
public class C<T> where T : I // CS0703 - I is internal; C<T> is 





Compiler Error CS0731 


程序 集 “assembly" 中 类 型 type" 的 类 型 转发 器 导致 循环 
仅 当 导入 的 源 数据 格式 错误 时 才 会 发 生 此 错误 。 仅 使 用 C# 源 代 码 不 会 出 现 此 错 


误 。 

下 面 的 示例 生成 CS0731。 此 示例 由 三 个 文件 组 成 : 
1.Circular.IL 

2.Circular2.IL 

3.CS0731.cs 

首先 将 .IL 文件 编译 为 库 ， 然 后 编译 引用 这 两 个 文件 的 .cs 代码 。 


// Curcular.il 
// compile with: /DLL /out-Circular.dll 
.assembly extern circular2 


,Ver 0:0:0:0 


Ww ma 


.assembly extern circular3 
{ 

.Ver 0:0:0:0 
j 


.assembly extern mscorlib 


{ 
.publickeytoken = (B7 7A 5C 56 19 34 EO 89 ) // .Z\V.4.. 
.Ver 2:0:0:0 
} 
„assembly Circular 
{ 
.custom instance void [mscorlib]System.Runtime.CompilerServices.( 
.hash algorithm 0x00008004 
.Ver 0:0:0:0 
} 


.class extern forwarder Circular.Referenced.TypeForwarder 


{ 
} 


.module Circular.dll 

// MVID: {880C2329-C915-42A0-83E9-9D10C3E6DBDO} 

.imagebase 0x00400000 

.file alignment 0x00000200 

.Stackreserve 0x00100000 

. subsystem 0x0003 // WINDOWS_CUI 

.corflags 0x00000001 //  ILONLY 

// Image base: 0x04E40000 

// ======== CLASS MEMBERS DECLARATION ========= 

.Class public abstract auto ansi sealed beforefieldinit User 
extends [mscorlib]System.Object 

{ 


.assembly extern circular2 


.method public hidebysig static class [circular2]Circular.Referer 
F() cil managed 
{ 


.maxstack 1 
newobj instance void [circular2]Circular.Referenced.TypeFo!: 
ret 





// Circular2 oil 
// compile with: /DLL /out-Circular2.dll 
.assembly extern mscorlib 


{ 
.publickeytoken = (B7 7A 5C 56 19 34 EO 89 ) EZ Np 
.Ver 2:0:0:0 

} 

„assembly extern Circular 

{ 
.Ver 0:0:0:0 

} 

„assembly circular2 

{ 
.custom instance void [mscorlib]System.Runtime.CompilerServices.( 
.hash algorithm 0x00008004 
.ver 0:0:0:0 

} 


.class extern forwarder Circular.Referenced.TypeForwarder 


{ 
} 


.module circular2.dll 

// MVID: {8B3BE5C8-DBE1-49C4-BC72-DF35F0387C21} 
.imagebase 0x00400000 

.file alignment 0x00000200 

.Stackreserve 0x00100000 

.Subsystem 0x0003 // | WINDOWS CUI 
.corflags 0x00000001 //  ILONLY 

// Image base: 0x04E40000 


到 .  H 


.assembly extern Circular 





// CS0731.cs 
// compile with: /reference:circular.dll /reference:circular2.dll 
// CS0731 expected 


class A ( 
public static void Main() ( 
User.F(); 
j 
j 


—————————————————Á—— áp itj 


Compiler Error CS0826 


找 不 到 隐 式 类 型 数组 的 最 佳 类 型 。 

数组 元 素 都 必须 为 同一 类 型 ， 或 者 可 根据 编译 器 所 使 用 的 类 型 推理 规则 隐 式 转换 为 
同一 类 型 。 最 佳 类 型 必须 为 数组 表达 式 中 的 类 型 之 一 。 元 素 不 会 转换 为 诸如 object 
之 类 的 新 类 型 。 对 于 隐 式 类 型 的 数组 ， 编 译 器 必须 根据 为 其 分 配 的 元 素 类 型 推断 该 
数组 的 类 型 。 


更 正 此 错误 

e 为 该 数组 指定 显 式 类 型 。 

e 为 所 有 数组 元 素 指定 同一 类 型 。 

e 为 可 能 会 导致 问题 的 那些 元 素 提供 显 式 强 制 转 换 。 
下 面 的 代码 生成 CS0826， 因 为 数组 元 素 的 类 型 不 完全 相同 ， 并 且 编 译 器 的 类 型 推 
理 逻 辑 未 找到 一 个 最 佳 类 型 : 

// cs0826.cs 

public class C 


public static int Main() 


var x = new[] { 1, "str" }; // CS0826 


chantei- "Gt: 
short s1 - 0; 
short s2 = -0; 
short s3 = 1; 
short s4 - -1; 


var arrayl = new[] { si, s2, s3, s4, c, '1' }; // CS0826 
return 1; 


隐 式 类 型 的 局 部 变量 (CH 编程 指南 ) 


Compiler Error CS0834 


lambda 表达 式 必 须 具 有 表达 式 体 才能 转换 为 表达 式 树 。 

要 转换 为 表达 式 树 的 lambda 必须 为 表达 式 lambda ; 语句 lambda 和 匿名 方法 只 能 
转换 为 委托 类 型 。 

更 正 此 错误 


1. M lambda 表达 式 中 移 除 语句 。 
下 面 的 示例 生成 CS0834 : 


// cs0834.cs 

using System; 

using System.Ling; 

using System.Linq.Expressions; 


public class C 


public static int Main() 


D 


Expression<Func<int, int»» e = x => ( return x; }; // CS08: 





Compiler Error CS0840 


"Property name" 必 须 声 明 主 体 ， 因 为 它 未 标记 为 abstract 或 extern。 自 动 实现 的 属 
性 必须 同时 定义 get 和 set 访问 器 。 


除非 常规 属性 被 标记 为 abstract 或 extern 或 者 作为 partial 类 型 的 成 员 ， 否 则 必 
须 为 其 提供 主体 。 自 动 实现 的 属性 不 提供 访问 器 体 ， 但 它们 必须 指定 两 个 访问 器 。 
若 要 创建 只 读 的 自动 实现 属性 ， 请 将 set 访问 器 设 为 private. 


更 正 此 错误 


1. 提供 缺少 的 主体 或 访问 器 ， 或 者 在 该 属性 和 /或 其 封闭 类 型 上 使 用 
abstract, extern 或 分 部 (3x 28) (C4 参考 ) 修饰 符 。 


下 面 的 示例 生成 CS0840 : 


// cs0840.cs 

// Compile with /target:library 
using System; 

class Test 


{ 
public int myProp { get; } // CS0840 


// to create a read-only property 
// try the following line instead 
public int myProp2 { get; private set; } 


请 参阅 


自动 实现 的 属性 (CH 编程 指南 ) 


4a iF 2344 ik CS0843 


在 控制 返回 到 调用 程序 之 前 ， 自 动 实现 的 属性 "name" 的 支持 字段 必须 完全 赋值 。 
请 考虑 从 构造 画 数 初始 值 设 定 项 中 调用 软 认 构造 画 数 。 


若 要 从 构造 画 数 中 为 自动 实现 的 属性 赋值 ， 必 须 首先 调用 默认 构造 画 数 以 创建 对 


o 


更 正 此 错误 


e 在 构造 函数 初始 值 设 定 项 中 添加 对 默认 构造 函数 的 调用 ， 如 以 下 示例 中 所 示 。 
请 注意 : this() 的 使 用 。 有 关 更 多 信息 ， 请 参见 this (CH 参考 ) 。 


示例 
下 面 的 代码 将 生成 CS0843 : 


// cs0843.cs 
struct S 
{ 
public int AIProp { get; set; } 
public S(int i){} //CS0843 
// Try the following lines instead. 
// public S(int i) : this() 
// 4 
// AIProp = i; 
// } 
} 


class Test 


( 


static int Main() 


i 
} 


return 1; 


Compiler Error CS0845 


表达 式 树 lambda 不 能 在 合并 运算 符 左 侧 包含 null 文本 。 
由 于 null 本 身 不 具有 类 型 ， 因 此 null 合并 运算 符 无 法 对 其 进行 运算 。 


更 正 此 错误 


1. 将 null 文本 强制 转换 为 对 象 。 
下 面 的 代码 将 生成 CS0845 : 

// cs0845.cs 

using System; 

using System.Ling; 


using System.Linq.Expressions; 


namespace ConsoleApplicationi 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Expression<Func<object>> e = () => null ?? null; // CS( 
// Try the following line instead. 
// Expression<Func<object>> e = () => (object)null ?? r 
} 
} 





Compiler Error CS1001 


应 输入 标识 符 
未 提供 标识 符 。 标 识 符 是 您 提供 的 类 、 结 构 、 命 名 空间 、 方 法 、 变 量 等 的 名 称 。 
下 面 的 示例 声明 一 个 简单 的 类 ， 但 没有 为 类 指定 名 称 : 


//cs1001.cs 
public class //CS1001 


i 
public int Num (get; set;j 
void MethodA() {} 


下 面 的 示例 之 所 以 会 生成 CS1001， 原 因 是 在 声明 枚 举 时 必须 指定 成 员 : 


// CS1001.cs 
public class clx 


( 


enum Colors : int 


‘a’, 'b' // CS1001, 'a' is not a valid int identifier 
// The following line shows examples of valid identifiers: 
// Blue, Red, Orange 

3 

public static void Main() 


t 
} 


| 


即使 编译 器 不 使 用 参数 名 (例如 ， 在 接口 定义 中 ) ， 也 需要 参数 名 。 需 要 这 些 参 
数 ， 以 便 使 用 接口 的 程序 员 能 够 对 参数 的 含义 有 所 了 解 。 


// CS1001-2.cs 
// compile with: /target:library 
interface IMyTest 


void TestFunci(int, int); // CS1001 


// Use the following line instead: 
// void TestFunci(int a, int b); 


j 


class CMyTest : IMyTest 


void IMyTest.TestFunci(int a, int b) 


请 参阅 


语句 、 表 达 式 和 运算 符 (CH 编程 指南 ) 
类 型 (CH 编程 指南 ) 


Compiler Error CS1009 


无 法 识别 的 转 义 序列 


在 z 字 符 串 中 反 斜 杠 () 的 后 面 是 一 个 意外 的 字符 。 编 译 器 需要 一 个 有 效 的 转 义 字 
符 。 有 关 详 细 信 息 ， 请 参阅 字符 转 义 。 


下 面 的 示例 生成 CS1009。 


// CS1009-a.cs 
class MyClass 


{ 
static void Main() 
{ 
// The following line causes CS1009. 
string a = "\m"; 
// Try the following line instead. 
// string a = "\t"; 
} 
} 


发 生 该 错误 的 原因 通 前 是 在 文件 名 中 使 用 了 反 和 斜 杠 字 符 ， 如 下 面 的 示例 所 示 : 


string filename = "c:\myFolder\myFile.txt"; 


若 要 纠正 该 错误 ， 请 使 用 "\* 或 前 面 带 有 @ 且 用 引号 括 起 的 字符 串 ， 如 下 面 的 示例 
所 示 : 


// CS1009-b.cs 
class MyClass 


{ 
static void Main() 
{ 
// The following line causes CS1009. 
string filename = "c:\myFolder\myFile.txt"; 
// Try one of the following lines instead. 
// string filename = "c:\\myFolder\\myFile.txt"; 
// string filename = Q"c:NmyFolderNmyFile.txt"; 
} 
} 
请 参阅 


string (C# 参考 ) 


MSDN C# 编程 指南 & 参考 手册 2015 


Compiler Error CS1009 1260 


Compiler Error CS1018 


应 输入 关键 字 “this” 或 “base” 

编译 器 遇 到 了 不 完整 的 构造 函数 声明 。 

下 面 的 示例 生成 CS1018 并 建议 了 几 种 解决 此 错误 的 方法 : 
// CS1018.cs 
public class C 


t 
} 


public class a : C 


( 


public a(int i) 
{ 
j 


public a () : // CS1018 

// possible resolutions: 

// public a () resolves by removing the colon 

// public a () : base() calls C's default constructor 

// public a () : this(1) calls the assignment constructor of c. 


{ 
j 
public static int Main() 
{ 
return 1; 
j 





Compiler Error CS1019 


应 输入 可 重 载 的 一 元 运算 符 

声明 了 类 似 于 重 载 的 一 元 运算 符 的 内 容 ， 但 缺少 该 运算 符 ， 或 该 运算 符 在 签名 中 的 
位 置 不 正确 。 

“一 元 运算 符 ? 是 一 种 对 单个 操作 数 进 行 运算 的 运算 符 。 例 如 ，++ 是 一 元 运算 符 。 您 
可 以 通过 使 用 operator 关键 字 并 指定 运算 符 所 运算 的 类 型 的 单一 参数 来 重 载 某 些 

一 元 运算 符 。 例 如 ， 如 果 要 为 用 户 定义 的 类 Temperature 重 载运 算 符 ++ 以 便 能 够 
&X Temperature++， 您 可 以 采用 以 下 方式 定义 该 类 : 


public static Temperature operator ++ (Temperature temp) 


temp.Degrees++; 
return temp; 


如 果 收 到 此 错误 ， 则 表明 您 声明 了 类 似 于 重 载 的 一 元 运算 符 的 内 容 ， 但 缺少 该 运算 
Dae 如 果 在 前 面 的 示例 中 从 签名 中 移 除了 ++， 
将 会 生成 CS1019。 


下 面 的 代码 生成 CS1019 : 


// CS1019 .cs 
public class ii 


{ 
int i 
{ 
get 
{ 
return 0; 
} 
} 
} 
public class a 
{ 


public int i; 
// Generates CS1019: "ii" is not a unary operator. 
public static a operator ii(a aa) 


// Use the following line instead: 
//public static a operator ++(a aa) 


{ 
aa.i++; 
return aa; 
} 
public static void Main() 
{ 
} 
} 
请 参阅 


i WM (CH 编程 指南 ) 


Compiler Error CS1026 


应 输入 ) 

找到 了 不 完整 的 语句 。 

发 生 该 错误 的 通常 原因 是 将 语句 而 不 是 表达 式 放 人 ASP.NET 页 中 的 内 联 表 达 式 
内 。 例 如 ， 以 下 表达 式 是 错误 的 : 


<%=new TimeSpan(DateTime.Now.Ticks - new DateTime(2001, 1, 1).Tick: 
正确 的 表达 式 应 如 下 : 





<%=new TimeSpan(DateTime.Now.Ticks - new DateTime(2001, 1, 1).Tick: 


其 解释 如 下 : 





<% Response.Write(new TimeSpan(DateTime.Now.Ticks - new DateTime(2( 
[i| eeu ———————— ee 
下 面 的 示例 生成 CS1026 : 





// CS1026 .cs 
Hif (a == b // CS1026, add closing ) 
Zendif 


class x 


public static void Main() 
{ 
} 

} 


Compiler Error CS1029 


error : "text" 


显示 用 #error 指令 定义 的 错误 文本 。 


下 面 的 示例 显示 如 何 创建 用 户 定 义 的 错误 : 


// CS1029 .cs 
class Sample 


static void Main() 


#error Let's give an error here // CS1029 


Compiler Error CS1061 

“type" 不 包含 member 的 定义 ， 并 且 找 不 到 可 接受 类 型 为 "type" 的 第 一 个 参数 的 扩 
展 方 法 "name"( 是 否 缺 少 using 指令 或 程序 集 引 用 ?)。 

在 尝试 调用 的 方法 或 访问 的 类 成 员 不 存在 时 ， 将 发 生 此 错误 。 

下 面 的 示例 生成 CS1061， 因 为 TestClass1 没有 DisplaySomething 方法 。 它 没有 
名 为 WriteSomething 的 方法 。 该 方法 可 能 是 此 源 代 码 的 作者 打算 编写 的 方法 。 


// cs1061.cs 
public class TestClass1 


{ 
// TestClassi has one method, called WriteSomething. 
public void WriteSomething(string s) 
{ 
System.Console.WriteLine(s); 
} 
} 
public class TestClass2 
{ 
// TestClass2 has one method, called DisplaySomething. 
public void DisplaySomething(string s) 
{ 
System.Console.WriteLine(s); 
} 
} 
public class TestTheClasses 
{ 
public static void Main() 
{ 
TestClassi tc1 = new TestClass1(); 
TestClass2 tc2 = new TestClass2(); 
// The following call fails because TestClass1 does not ha 
// a method called DisplaySomething. 
tc1.DisplaySomething("Hello"); // CS1061 
// To correct the error, change the method call to either 
// tci.WriteSomething or tc2.DisplaySomething. 
tc1.WriteSomething("Hello from TestClass1"); 
tc2.DisplaySomething("Hello from TestClass2"); 
} 
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Compiler Error CS1112 
T fh FH"System.Runtime.CompilerServices.ExtensionAttribute", i% A “this” % 
键 字 。 


当 在 包含 扩展 方法 的 非 静态 类 上 使 用 ExtensionAttribute 时 ， 会 生成 此 错误 。 如 果 
在 静态 类 上 使 用 此 特性 ， 则 可 能 会 发 生 其 他 错误 ， 如 CS0708 : “不 能 在 静态 类 中 声 
明 实 例 成 员 ”。 


在 C# 中 ， 必 须 在 静态 类 中 定义 扩展 方法 ， 并 用 this 关键 字 修饰 该 方法 的 第 一 个 参 
数 。 任 何 情况 下 都 不 要 在 源 代码 中 使 用 该 特性 。 有 关 更 多 信息 ， 请 参见 扩展 方法 
(C? 编程 指南 ) o 


更 正 此 错误 


1. 移 除 该 特性 ， 然 后 将 this 修饰 符 应 用 于 该 方法 的 第 一 个 参数 。 
下 面 的 示例 生成 CS1112 : 


CSS 
[System.Runtime.CompilerServices.ExtensionAttribute] // CS1112 
public class Extensions 


public bool A(bool b) { return b; } 
} 


class A { } 


aif artaik CS1501 


“method" 方 法 的 重 载 不 带 有 "number 个 参数 
对 类 方法 进行 了 调用 ， 但 没有 带 有 所 需 数目 的 参数 的 方法 的 定义 。 
下 面 的 示例 生成 CS1501。 


using System; 


namespace ConsoleApplicationi 


( 


class Program 


( 


j 


static void Main(string[] args) 


{ 
ExampleClass ec = new ExampleClass(); 
ec.ExampleMethod(); 
ec.ExampleMethod(10); 
// The following line causes compiler error CS1501 bec: 
// ExampleClass does not contain an ExampleMethod that 
// two arguments. 
ec.ExampleMethod(10, 20); 

} 


// ExampleClass contains two overloads for ExampleMethod. One « 
// has no parameters and one has a single parameter. 
class ExampleClass 


( 


public void ExampleMethod() 


{ 
Console.WriteLine("Zero parameters"); 
j 
public void ExampleMethod(int i) 
{ 
Console.WriteLine("One integer parameter."); 
j 


//// To fix the error, you must add a method that takes tw 
//public void ExampleMethod (int i, int j) 

//{ 

// Console.WriteLine("Two integer parameters."); 

//} 








Compiler Error CS1502 


与 "name" 最 匹配 的 重 载 方 法 有 一 些 无 效 参 数 


当 正 传 递 到 方法 的 参数 类 型 与 该 方法 的 参数 类 型 不 匹配 时 发 生 该 错误 。 如 果 重 载 调 
用 的 方法 ， 则 重 载 的 任何 版 本 都 不 具有 和 与 正 进行 传递 的 参数 类 型 相 匹配 的 签名 。 


若 要 解决 该 问题 ， 请 执行 以 下 操作 : 


e 仔细 检查 正 进 行 传递 的 参数 的 类 型 。 确 保 它们 与 正 调用 的 方法 的 参数 类 型 相 匹 
配 。 


e 如 果 可 以 ， 请 使 用 Convert 类 转换 任何 不 匹配 的 参数 。 

e 如 果 可 以 ， 请 强制 转换 所 有 不 匹配 的 参数 使 它们 与 该 方法 需要 的 类 型 相 匹配 。 

e 如 果 可 以 ， 请 定义 该 方法 的 其 他 重 载 版 本 以 便 与 正 要 发 送 的 参数 类 型 相 匹配 。 
下 面 的 示例 生成 CS1502 : 


// CS1502.cs 
namespace x 


public class a 
public a(char i) 
// try the following constructor instead 
// public a(int i) 
{ 
} 


public static void Main() 


a aa = new a(2222); // 0851502 


Compiler Error CS1519 


类 、 结 构 或 接口 成 员 声 明 中 的 标记 “token” 无 效 


每 当 在 茶 个 标记 未 隶属 的 位 置 中 遇 到 该 标记 时 ， 都 会 产生 此 错误 。 "标记 "是 关键 
字 ; 标识 符 (类 、 结 构 、 方 法 等 的 名 称 ) ; 字符 串 、 字 符 或 数字 文本 值 (例如 
108、"Hello" 或 'A') ; 或 者 是 运算 符 或 标点 的 形式 (例如 == 或 ;) 。 


任何 在 类 型 的 前 面包 含 无 效 修饰 符 的 class、 结 构 或 接口 的 成 员 声明 都 将 生成 该 错 
误 。 若 要 修复 此 错误 ， 请 移 除 无 效 的 修饰 符 。 


下 面 的 示例 会 在 五 个 位 置 生成 CS1519， 因 为 标记 放 在 其 无 效 的 位 置 


// CS1519 .cs 
// Generates CS1519 because a class name cannot be a number: 
class Test 42 


{ 
// Generates CS1519 because of 'j' following 'I' 


// with no comma between them: 
int ab og |e 

// Generates CS1519 because of "checked" on void method: 
checked void f4(); 


// Generates CS1519 because of "num": 
void f5(int a num) {} 


// Generates CS1519 because of namespace inside class: 
namespace; 


请 参阅 


X (CH 编程 指南 ) 

结构 (CH 编程 指南 ) 
接口 (CH 编程 指南 ) 
方法 (CH 编程 指南 ) 


Compiler Error CS1540 


无 法 通过 类 型 type1” 的 限定 符 访问 保 扩 成员"”member” ; 限定 符 必 须 是 类 
型 “type2”( 或 者 从 该 类 型 派生 的 ) 


派生 的 类 无 法 通过 基 类 的 实例 来 访问 其 基 类 的 受 保 扩 成 员 。 在 派生 的 类 中 声明 的 基 
类 的 实例 在 运行 时 可 能 是 另 一 个 类 型 的 实例 ， 该 类 型 从 相同 的 基 派 生 但 与 派生 的 类 
无 关 。 由 于 受 保 护 成 员 只 可 由 派生 的 类 型 访问 ， 因 此 要 访问 可 能 在 运行 时 无 效 的 受 
保护 成 员 的 任何 党 试 都 会 由 编译 器 标记 为 无 效 。 


在 以 下 示例 中 的 Employee 类 中 ，emp2 和 emp3 在 编译 时 都 具有 类 型 Person， 但 
emp2 在 运行 时 具有 类 型 Manager。 由 于 Employee 未 从 Manager 派生 ， 因 此 它 
不 能 通过 Manager 类 的 实例 来 访问 基 类 Person 的 受 保护 成 员 。 编 译 器 无 法 确定 两 
个 Person 对 象 的 运行 时 类 型 将 是 什么 类 型 。 因 此 ， 来 自 emp2 的 调用 和 来 自 
emp3 的 调用 都 会 导致 编译 器 错误 CS1540。 


using System; 
using System.Text; 


namespace CS1540 


( 


class Programi 


{ 
static void Main() 
{ 
Employee.PreparePayroll(); 
} 
} 
class Person 
{ 
protected virtual void CalculatePay() 
{ 
Console.WriteLine("CalculatePay in Person class."); 
j 
} 
class Manager : Person 
{ 
protected override void CalculatePay() 
{ 
Console.WriteLine("CalculatePay in Manager class."); 
} 
} 
class Employee : Person 
{ 
public static void PreparePayroll() 
{ 
Employee emp1 = new Employee(); 
Person emp2 = new Manager (); 
Person emp3 = new Employee(); 
// The following line calls the method in the Employee 
// Person. 
emp1.CalculatePay(); 
// The following lines cause compiler error CS1540\. TI 
// cannot determine at compile time what the run-time 1 
// emp2 and emp3 will be. 
//emp2.CalculatePay(); 
//emp3.CalculatePay(); 
} 
} 
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请 参阅 

继承 (CH 编程 指南 ) 

ZAM (CH 编程 指南 ) 

访问 修饰 符 (CH 编程 指南 ) 

抽象 类 、 密 封 类 及 类 成 员 (CH 编程 指南 ) 


Compiler Error CS1540 
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Compiler Error CS1546 


属性 、 索 引 器 或 事件 "property" 不 受 该 语言 支持 ; 请 尝试 直接 调用 访问 器 方 
法 “accessor” 


代码 正在 使 用 具有 默认 索引 属性 的 对 象 ， 并 党 试 使 用 索引 语法 。 若 要 解决 该 错误 ， 
T nimus 有 关 索 引 器 和 属性 的 更 多 信息 ， 请 参见 索引 器 (C# 编 
程 指南 ) 。 


下 面 的 示例 生成 CS1546。 


此 代码 示例 由 一 个 编译 为 .dll 的 .cpp 文件 和 一 个 使 用 该 .dll 的 .cs 文件 组 成 。 下 面 
是 .dll 文件 的 代码 ， 它 定义 了 一 个 将 由 .cs 文件 中 的 代码 访问 的 属性 。 


// CPP1546.cpp 

// compile with: /clr /LD 
using namespace System; 
public ref class MCPP 


{ 
public: 
property int Prop [int,int] 
{ 
int get( int i, int b ) 
return i; 
} 
} 
}; 


这 是 C# 文件 。 


// CS1546.cs 

// compile with: /r:CPP1546.dll 
using System; 

public class Test 


public static void Main() 


{ . . 
int 1 = 0; 
MCPP mcpp = new MCPP(); 
i = mcpp.Prop(1,1); // CS1546 
// Try the following line instead: 
// i - mcpp.get Prop(1,1); 
} 


Compiler Error CS1548 


对 程序 集 “assembly” 签 名 时 加 密 失 败 —"reason" 


程序 集 签名 失败 时 将 发 生 CS1548。 这 通常 是 由 于 无 效 的 密 钥 文件 名 称 、 无 效 的 密 
钥 文 件 路 径 或 已 损坏 的 密 钥 文件 而 造成 的 。 

若 要 对 程序 集 进行 完全 签名 ， 必 须 提 供 包 含 公 钥 和 私 钥 信息 的 有 效 密 钥 文件 。 若 要 
延迟 对 程序 集 的 签名 ， 必 须 选 择 “ 仅 延迟 签名 ” 复 选 框 ， 并 提供 包含 公 钥 信息 的 有 效 
密 钥 文件 。 当 程序 集 为 延迟 签名 时 ， 不 需要 使 用 私有 密 钥 。 

有 关 更 多 信息 ， 请 参见 How to: Sign an Assembly (Visual Studio), /keyfile (C£ 
Compiler Options) 和 /delaysign (C£ Compiler Options); 


创建 程序 集 时 ，C# 编译 器 会 调 入 一 个 名 为 “al.exe” 的 实用 工具 。 如 果 在 创建 程序 集 
时 出 现 失 败 ，al.exe 会 报告 失败 的 原因 。 请 参见 Al.exe Tool Errors and 
Warnings， 并 搜索 与 编译 器 在 “原因 ”中 报告 的 文本 相对 应 的 主题 。 


请 参阅 


How to: Sign an Assembly (Visual Studio) 


Compiler Error CS1564 


指定 的 选项 冲突 : Win32 资源 文件 ; Win32 清单 。 


如 果 使 用 /Win32res 编译 器 选项 ， 则 必须 在 资源 文件 中 包含 自 定义 Win32 清单 
(如 果 需 要 ) 。 自 定义 Win32 清单 必须 与 Win32 资源 文件 一 起 提供 。 只 有 在 未 指 
定 win32 资源 文件 时 ， 才 使 用 /win32manifest 选项 。 


更正 此 错误 


1. 将 win32 清单 添加 到 win32 资源 文件 中 ， 并 移 除 /win32manifest 编译 器 选 


项 。 


下 面 的 示例 在 用 /Win32res 选项 编译 并 且 资 源 文件 中 未 包含 清单 时 会 生成 
CS1564。 


// cs1564.cs 
// Compile with: /Win32res 
public class Test 


{ 
static int Main(string[] args) 
{ 
return 1; 
j 
j 


C# 3.0 编译 器 为 所 有 二 进 制 文件 添加 了 默认 的 win32Manifest. 


请 参阅 
/win32manifest (C£ Compiler Options) 
/win32res (C£ Compiler Options) 


Compiler Error CS1567 


生成 Win32 资源 时 出 错 : "file" 

您 的 编译 或 者 使 用 了 /win32icon 编译 器 选项 ， 或 者 未 使 用 /win32res 编译 器 选项 ， 
这 导致 编译 器 生成 包含 资源 信息 的 文件 ， 但 编译 器 因 磁 盘 空 间 不 足 或 其 他 某 些 错误 
而 无 法 创建 文件 。 


如 果 您 无 法 解决 此 文件 生成 问题 ， 可 以 使 用 /win32res， 该 编译 器 选项 不 生成 包含 
资源 信息 的 文件 。 


Compiler Error CS1579 
foreach 语句 不 能 对 “type1” 类 型 的 变量 进行 操作 ， 因 为 “type2” 不 包 合 "identifier" 的 公 


若 要 使 用 foreach 语句 循环 访问 某 个 集合 ， 该 集合 必须 满足 以 下 要 求 : 
必须 是 一 个 接口 、 类 或 结构 。 
须 包 含 一 个 返回 类 型 的 公共 GetEnumerator 方法 。 


它 
tu M 

e 返回 类 型 必须 包含 一 个 名 为 Current 的 公共 属性 和 一 个 名 为 MoveNext 的 公共 
方 


e 有 关 更 多 信息 ， 请 参见 如 何 : 使 用 foreach 访问 集合 类 (CH 编程 指南 ) 。 


在 本 示例 中 ，foreach 无 法 循环 访问 集合 ， 因 为 MyCollection 集合 中 没有 
publicGetEnumerator 方法 。 


下 面 的 示例 生成 CS1579。 


// CS1579 .cs 
using System; 
public class MyCollection 
{ 
int[] items; 
public MyCollection() 
{ 
items = new int[5] (12, 44, 33, 2, 50); 
} 


// Delete the following line to resolve. 
MyEnumerator GetEnumerator() 


// Uncomment the following line to resolve: 
// public MyEnumerator GetEnumerator() 


{ 
} 


// Declare the enumerator class: 
public class MyEnumerator 
{ 
int nIndex; 
MyCollection collection; 
public MyEnumerator(MyCollection coll) 
t 
collection - coll; 
nIndex = -1; 


return new MyEnumerator(this); 


public bool MoveNext() 


{ 
nIndex++; 
return(nIndex < collection.items.GetLength(0)); 
} 
public int Current 
{ 
get 
{ 
return(collection.items[nIndex]); 
} 
} 
} 
public static void Main() 
{ 


MyCollection col = new MyCollection(); 
Console.WriteLine("Values in the collection are:"); 
foreach (int i in col) // CS1579 

{ 


} 


Console.WriteLine(i); 


Compiler Error CS1612 


无 法 修改 “expression” 的 返回 值 ， 因 为 它 不 是 变量 


尝试 修改 作为 中 间 表 达 式 的 结果 生成 但 未 存储 在 变量 中 的 值 类 型 。 如 果 尝 试 直接 修 
改 泛 型 集合 中 的 结构 ， 则 会 发 生 此 错误 ， 如 下 面 的 示例 所 示 : 


List«myStruct» list = (.); 
list[0].Name - "MyStruct42"; //CS1612 


若 要 修改 结构 ， 请 首先 将 其 赋 给 局 部 变量 ， 修 改 该 变量 ， 然 后 将 该 变量 赋 回 给 集合 
中 的 项 。 


List«myStruct» list = {..}; 
MyStruct ms = list[0]; 

ms . Name "MyStruct42"; 
list[0] ms; 


之 所 以 会 发 生 此 错误 ， 原 因 是 在 赋值 时 复制 了 值 类 型 。 在 从 属性 或 素 引 器 中 检索 值 
类 型 时 ， 所 获取 的 是 对 象 的 副本 ， 而 不 是 对 于 对 象 本 身 的 引用 。 RE 
实际 上 是 方法 ， 而 不 是 存储 位 置 (变量 ) ， 因 此 它们 不 存储 返回 的 副本 。 您 必须 将 
BAG HERA SSH, ABTA 6 对 其 进行 修改 。 


引用 类 型 不 会 发 生 此 错误 ， 因 为 在 这 种 情况 下 ， 属 性 或 索引 器 将 返回 对 现 有 对 象 的 
引用 ， 而 对 象 是 存储 位 置 。 


如 果 是 在 定义 类 或 结构 ， 则 修改 属性 声明 ， 提 供 对 结构 成 员 的 访问 ， 即 可 解决 此 错 
误 。 如 果 是 在 编写 客户 端 代码 ， 则 创建 您 自己 的 结构 实例 ， 修 改 其 字段 ， 然 后 将 整 
个 结构 赋 回 给 该 属性 ， 即 可 解决 此 错误 。 第 三 种 蔡 代 方 式 是 ， 您 可 以 将 结构 更 改 为 


sk 
Ro 


当 您 尝试 通过 将 返回 整个 结构 的 封闭 类 的 属性 来 访问 结构 的 成 员 时 ， 也 会 发 生 
CS1612， 如 下 面 的 示例 所 示 : 


// €3$1612.¢s 
using System; 


public struct MyStruct 


1 
public int Width; 
} 
public class ListView 
{ 
MyStruct ms; 
public MyStruct Size 
{ 
get { return ms; } 
set { ms = value; } 
} 
} 
public class MyClass 
{ 
public MyClass() 
{ 
ListView lvi; 
lvi = new ListView(); 
lvi.Size.Width = 5; // CS1612 
// You can use the following lines instead. 
// MyStruct ms; 
// ms.Width - 5; 
// lvi.Size = ms; // CS1612 
} 
public static void Main() 
{ 
MyClass mc = new MyClass(); 
// Keep the console open in debug mode. 
Console.WriteLine("Press any key to exit."); 
Console.ReadKey(); 
} 
} 
请 参阅 


结构 (CH 编程 指南 ) 
值 类 型 (CH 参考 ) 
引用 类 型 (C4 参考 ) 


Compiler Error CS1614 


“name” 不 明确 的 ; 在 “attribute1” 和 “attribute2” 之 间 。 请 使 用 " 
@attribute” 或 “attributeAttribute” 


编译 器 遇 到 了 意义 不 明确 的 特性 指定 。 


为 简便 起 见 ，C# 编译 器 允许 将 ExampleAttribute 指定 为 [Example] F, WR 
名 为 Example 的 特性 类 与 ExampleAttribute 同时 存在 ， 则 会 引起 多 义 性 ， 因 为 
编译 器 无 法 判断 [Example] 是 指 Example 特性 还 是 指 ExampleAttribute 特性 。 
要 解决 此 问题 ， 请 对 Example 特性 使 用 [@Example], xt ExampleAttribute 使 用 
[ExampleAttribute]. 


下 面 的 示例 生成 CS1614 : 


// 


CS1614.cs 


using System; 


Both of the following classes are valid attributes with valid 
names (MySpecial and MySpecialAttribute). However, because the : 
rules for attributes involves auto-appending the 'Attribute' su! 
to the identifier, these two attributes become ambiguous; that : 
if you specify MySpecial, the compiler can't tell if you want 
MySpecial or MySpecialAttribute. 


public class MySpecial : Attribute { 


j 


public MySpecial() {} 


public class MySpecialAttribute : Attribute { 


j 


public MySpecialAttribute() {} 


class MakeAWarning { 


[MySpecial()] // CS1614 
// Ambiguous: MySpecial or MySpecialAttribute? 
public static void Main() ( 


j 


[@MySpecial()] // This isn't ambiguous, it binds to the first al 
public static void NoWarning() { 


j 


[MySpecialAttribute()] // This isn't ambiguous, it binds to the 
public static void NoWarning2() { 


j 


[@MySpecialAttribute()] // This is also legal. 
public static void NoWarning3() { 





Compiler Error CS1640 
foreach 语句 不 能 对 "type" 类 型 的 变量 进行 操作 ， 因 为 它 实现 "interface” 的 多 个 实例 
化 ， 请 尝试 强制 转换 为 特定 的 接口 实例 化 


此 类 型 从 <T> 的 两 个 或 更 多 的 实例 继承 ， 这 意味 着 不 存在 foreach 可 以 使 用 的 类 型 
唯一 枚 举 。 指 定 IEnumeratorr<T> 的 类 型 ， 或 使 用 其 他 循环 构造 。 


下 面 的 示例 生成 CS1640 : 


// CS1640.cs 

using System; 

using System.Collections; 

using System.Collections.Generic; 

public class C : IEnumerable, IEnumerable<int>, IEnumerable<string: 
{ 


IEnumerator«int» IEnumerable<int>.GetEnumerator () 


yield break; 
} 


IEnumerator<string> IEnumerable<string>.GetEnumerator() 


yield break; 


j 
IEnumerator IEnumerable.GetEnumerator() 
{ 
return (IEnumerator )((IEnumerable<string>) this) .GetEnumerat 
j 


} 


public class Test 


public static int Main() 


{ 
foreach (int i in new C()){} // CS1640 
// Try specifing the type of IEnumerable<T> 
// foreach (int i in (IEnumerable<int>)new C()){} 
return 1; 
j 











Compiler Error CS1644 


功能 “feature” 不 是 标准 化 ISO CH 语言 规范 的 一 部 分 ， 有 些 编译 器 可 能 不 接受 它 


如 果 您 指定 了 /langversion 选项 ISO-1， 而 您 编译 的 代码 所 使 用 的 功能 不 是 ISO 
1.0 标准 的 组 成 部 分 ， 则 会 发 生 此 错误 。 若 要 解决 此 错误 ， 请 不 要 对 任何 CH 2.0 编 
译 器 功能 (如 泛 型 或 匿名 方法 ) 使 用 ISO-1 兼容 性 选项 。 


下 面 的 示例 生成 CS1644 : 
// CS1644.cs 


// compile with: /langversion:ISO-1 /target:library 
class C<T> {} // CS1644 


Compiler Error CS1656 


无 法 给 "variable" 赋 值 ， 因 为 它 是 "read-only variable type" 


当 变 量 赋值 发 生 在 只 读 上 下 文中 时 ， 将 出 现 此 错误 。 只 读 上 下 文 包括 foreach XXX 
变量 、using 变量 和 fixed 变量 。 若 要 解决 此 错误 ， 请 避免 在 using 块 、foreach 
语句 和 fixed 语句 中 给 变量 赋值 。 


以 下 示例 生成 错误 CS1656， 因 为 它 党 斌 替换 foreach 循环 内 的 集合 中 的 所 有 元 
素 。 解 决 此 错误 的 一 种 方法 是 将 foreach 循环 更 改 为 for 循环 。 另 一 种 方法 Gb. 
未 显示 ) 是 修改 现 有 元 素 的 成 员 ; 这 可 能 对 类 起 作用 ， 但 对 结构 不 起 作用 。 


using System; 

using System.Collections; 

using System.Collections.Generic; 
using System.Text; 


namespace CS1656 2 


{ 
class Book 
public string Title; 
public string Author; 
public double Price; 
public Book(string t, string a, double p) 
{ 
Title=t; 
Author=a; 
Price=p; 
} 
} 
class Program 
{ 


private List<Book> list; 
static void Main(string[] args) 
{ 
Program prog = new Program(); 
prog.list = new List<Book>(); 
prog.list.Add(new Book ("The C# Programming Language", 
"Hejlsberg, Wiltamuth, Golde", 
29.95)); 
prog.list.Add(new Book ("The C++ Programming Language", 
"Stroustrup", 
29.95)); 
prog.list.Add(new Book ("The C Programming Language", 
"Kernighan, Ritchie", 


29.95)); 
foreach(Book b in prog.list) 


{ 
// Cannot modify an entire element in a foreach loc 
// even with reference types. 
// Use a for or while loop instead 
if (b.Title == "The C Programming Language" ) 
// Cannot assign to 'b' because it is a 'foreac 
// iteration variable' 
b = new Book("Programming Windows, 5th Ed.", "I 
} 


//With a for loop you can modify elements 
//for(int x = 0; x < prog.list.Count; x++) 


/AL 
// if(prog.list[x].Title-- "The C Programming Langu: 
// prog.list[x] = new Book("Programming Windows, 
//} 


//foreach(Book b in prog.list) 
// Console.WriteLine(b.Title); 





下 面 的 示例 演示 如 何在 除 foreach 循环 之 外 的 其 他 上 下 文中 生成 CS1656 : 


// CS1656 .cs 
// compile with: /unsafe 
using System; 


class C : IDisposable 


{ 
public void Dispose() ( } 
} 
class CMain 
{ 
unsafe public static void Main() 
{ 
using (C c = new C()) 
{ 
// Cannot assign to 'c' because it is a 'using variable 
c - new C(); // CS1656 
} 
int[] ary = new int[] (1, 2, 3, 4 }; 
fixed (int* p = ary) 
{ 
// Cannot assign to 'p' because it is a 'fixed variable 
p = null; // CS1656 
} 
} 





Compiler Error CS1674 


“T” : using 语句 中 使 用 的 类 型 必须 可 以 隐 式 转换 为 "System.IDisposable” 


using 语句 旨 在 用 于 确保 在 using 块 的 最 后 处 置 对 象 ， 因 此 只 有 可 人 处置 的 类 型 才能 
在 这 类 语句 中 使 用 。 例 如 ， 值 类 型 不 是 可 处 置 的 ， 并 且 没 有 约束 为 类 的 类 型 参数 不 
能 假定 为 可 处置 。 


下 面 的 示例 生成 CS1674。 


// CS1674.cs 
class C 


public static void Main() 


{ 
int a = 0; 
att; 


using (a) (3 // CS1674 


下 面 的 示例 生成 CS1674。 


// CS1674 b.cs 
using System; 
class C ( 
public void Test() { 
using (C c = new C()) {} // CS1674 


j 


// OK 

class D : IDisposable ( 
void IDisposable.Dispose() {} 
public void Dispose() {} 


public static void Main() { 
using (D d = new D()) (3 


下 面 的 示例 说 明了 需要 使 用 一 个 类 类 型 约束 来 确保 未 知 的 类 型 参数 是 可 释放 的 。 下 
面 的 示例 生成 CS1674。 


// CS1674 c.cs 
// compile with: /target:library 
using System; 
public class C«T» 
// Add a class type constraint that specifies a disposable class. 
// Uncomment the following line to resolve. 
// public class C<T> where T : IDisposable 
{ 
public void F(T t) 


{ 
using (t) {} // CS1674 


ER 


Compiler Error CS1703 
已 导入 了 具有 相同 的 简单 名 称 "name"” 的 程序 集 。 请 尝试 移 除 其 中 一 个 引用 ， 或 者 给 
引用 加 上 签名 以 启用 并 列 模 式 。 


编译 器 移 除 有 相同 的 路 径 和 文件 名 称 的 引用 ， 但 有 可 能 相同 的 文件 在 两 个 位 置 都 存 
在 ， 或 者 您 所 了 更 改版 本 号 。 此 错误 指出 两 个 引用 具有 相同 的 程序 集 标识 ， 因 此 编 
译 器 无 法 在 元 数据 中 区 分 它们 。 或 者 移 除 其 中 的 一 个 元 余 引 用 ， 或 者 用 某 种 办 法 使 
引用 一 致 ， 例 如 通过 提高 程序 集 版 本 号 。 


以 下 代码 生成 错误 CS1703。 

此 代码 在 .\bin1 目 录 创 建 A 程 序 集 . 

将 此 示例 保存 在 名 为 CS1703a1.cs 的 文件 中 ， 并 用 以 下 标志 编译 该 文件 : /t:library 
/out:.\bin1\cs1703.dll /keyfile:key.snk 


using System; 
public class A { } 


此 代码 在 .\bin2 目 录 创 建 A 程 序 集 。 
将 此 示例 保存 在 名 为 CS1703a2.cs 的 文件 中 ， 并 用 以 下 标志 编译 该 文件 : /t:library 
/out:.\bin2\cs1703.dll /keyfile:key.snk 


using System; 
public class A { } 


此 代码 引用 前 面 两 个 模块 中 的 程序 集 A。 
将 此 示例 保存 在 名 为 CS1703ref.cs 的 文件 中 ， 并 用 以 下 标志 编译 该 文件 : Itlibrary 
/r:A2=.\bin2\cs1703.dll /r:A1=.\bin1\cs1703.dll 


extern alias A1; 
extern alias A2; 


Compiler Error CS1704 


已 导入 具有 相同 简单 名 称 “Assembly Name” 的 程序 集 。 请 尝试 移 除 其 中 一 个 引用 ， 
或 者 给 引用 加 上 签名 以 启用 并 列 模式 。 


此 错误 指出 有 两 个 引用 具有 相同 的 程序 集 标识 ， 这 是 因为 相关 程序 集 缺 少 强 名 称 而 
且 没 有 签名 ， 因 而 编译 器 无 法 在 元 数据 中 区 分 它们 。 因 此 ， 运 行 时 会 忽略 版 本 和 区 
域 性 程序 集 名 称 属性 。 用 户 应 移 除 多 余 的 引用 ， 重 命名 其 中 一 个 引用 ， 或 者 为 它们 
提供 一 个 强 名 称 。 


此 示例 创建 一 个 程序 集 并 将 它 保存 到 根 目录 下 。 


// CS1704 a.cs 
// compile with: /target:library /out:c:NNcs1704.d11 
public class A {} 


此 示例 创建 一 个 与 上 面 的 示例 同名 的 程序 集 ， 但 将 它 保存 到 不 同 的 位 置 。 


// CS1704_b .cs 
// compile with: /target:library /out:cs1704.dll 
public class A {} 


此 示例 尝试 引用 这 两 个 程序 集 。 下 面 的 示例 生成 CS1704。 


// CS1704 c.cs 

// compile with: /target:library /r:A2-cs1704.dll /r:A1=c:\\cs1704 
// CS1704 expected 

extern alias A1; 

extern alias A2; 





Compiler Error CS1705 
程序 集 “AssemblyName1” 所 使 用 的 “TypeName” 的 版 本 高 于 所 引用 的 程序 
集 “AssemblyName2” 的 版 本 


您 要 进入 一 个 版 本 号 高 于 所 引用 的 程序 集 的 版 本 号 的 类 型 。 此 错误 通常 由 意外 使 用 
相同 程序 集 的 两 个 版 本 引发 。 


例如 ， 假 设 您 有 两 个 程序 集 ，Asmb1 和 Asmb2。 程 序 集 Asmb1 引用 生成 程序 集 
Asmb2 1.0。 程 序 集 Asmb1 还 使 用 已 添加 到 2.0 版 的 程序 集 Asmb2 的 类 
MyClass。 编 译 器 有 一 致 性 绑 定 引用 规则 ， 对 2.0 版 的 MyClass 的 引用 无 法 由 1.0 
版 满足 。 
下 面 详 细 示 例 由 四 个 代码 模块 : 

e 两 个 DLL， 它 们 除了 版 本 特性 外 ， 其 他 方面 都 是 一 样 的 。 

e 引用 前 两 个 的 第 三 个 DLL. 

e 引用 相同 的 DLL 的 1.0 版 本 的 客户 ， 但 是 ， 从 版 本 2.0 访问 的 类 。 
下 面 的 代码 创建 两 个 相同 的 DLL 中 的 第 一 个 。 有 关 如 何 生 成 密 钥 文件 的 信息 ， 请 参 
见 /keyfile (C# Compiler Options)。 

// CS1705a.cs 


// Compile by using the following command: 
// csc /target:library /out:C:NNCS1705.dll /keyfile:mykey.snk 


// The DLL is created in the C:\ directory. 
// The AssemblyVersion attribute specifies version 1.0 for this DLI 


[assembly:System.Reflection.AssemblyVersion("1.0")] 
public class Classi 


public void Methodi() {} 





下 面 的 代码 定义 是 程序 集 2.0 版 ， 由 特性 AssemblyVersionAttribute 指定 。 


// CS1705b ,cs 


// Compile by using the following command: 
YA csc /target:library /out:CS1705.dll /keyfile:mykey.snk CS17( 


// The DLL is created in the current directory. 
// The AssemblyVersion attribute specifies version 2.0 for this DLI 


[assembly:System.Reflection.AssemblyVersion("2.0")] 
public class Classi 


public void Methodi() { } 





下 面 的 代码 引用 前 面 的 代码 中 定义 的 两 个 DLL 版 本 。 AssemblyA 引用 CS1705 

a.cs (版 本 1.0) 创 建 的 DLL, AssemblyB 引用 CS1705b.cs (版 本 2.0) 创 建 的 

DLL, 两 个 方法 是 在 ClassC 中 定义 的 。 第 一 ，Return1A， 它 返回 Class1A 类 型 的 

对 象 ， 是 从 DLL 版 本 1.0 的 Class1 的 别名 。 第 二 ，Return1B， 它 返回 Class1B X 

型 的 对 象 ， 是 从 DLL 版 本 2.0 的 Class1 的 别名 。 Return1A 的 定义 在 版 本 1.0 上 创 

oe 这 些 依赖 关系 ; Return1B 的 定义 在 创建 版 本 2.0 上 创建 一 个 依赖 
Ro 


// CS1705c.cs 


// Compile by using the following command. AssemblyA refers to the 
// CS1705a.cs (version 1.0). AssemblyB refers to the DLL created b 
// (version 2.0). 

M csc /target:library /r:AssemblyA-C:NNCS1705.dll /r:AssemblyB: 


extern alias AssemblyA; 
extern alias AssemblyB; 


// Class1A is an alias for type Classi from VS1705a.cs, which is ir 
// of the assembly. ClassiB is an alias for type Classi from CS170! 
// is in version 2.0 of the assembly. 


using Class1A 
using Class1B 


- AssemblyA::Class1; 

- AssemblyB::Class1; 

// Method Returni1A in ClassC returns an object of type Class1A, wh: 
// Classi from version 1.0 of the DLL. Method ReturniB returns an ( 
// of type Class1B, which is Classi from version 2.0 of the DLL. 


public class ClassC 

{ 
// The following line creates a dependency on version 1.0 of C: 
// This is not the source of the problem when ClassC is access: 
// CS1705d.cs because CS1705d.cs references version 1.0 of the 
// Therefore, type Class1A and the assembly have the same vers: 
public static Class1A ReturniA() { return new Class1A(); } 


// The following line creates a dependency on version 2.0 of C: 
// This causes compiler error CS1705 when ClassC is accessed fi 
// CS1705d.cs, because CS1705d.cs does not reference version 2 
// DLL. ClassiB is the alias for Classi in version 2.0, and CS: 
// references version 1.0. 

public static Class1B ReturniB() { return new Class1B(); } 





下 面 的 代码 可 生成 编译 器 错误 CS1705。 它 引用 CS1705 a.cs (版 本 1.0) 创 建 的 DLL 

。 但 是 ， 在 Main 方法 中 ， 代 码 从 CS1705 c.cs 的 ClassC 来 访问 。 ClassC 使 用 在 
CS1705 b.cs(2.0 版 ) 中 定义 的 类 型 。 这 导致 编译 器 错误 CS1705， 因 为 类 型 具有 高 
于 引用 的 CS1705.dll 的 版 本 号 的 CS1705 的 .dll 的 版 本 号 。 


// CS1705d.cs 


// Compile by using the following command: 
// csc /reference:C:NNCS1705.dll /reference:CS1705c.dll CS1705¢ 


// C:NNCS1705.dll is version 1.0 of the assembly. 


class Tester 


{ 
static void Main() 
{ 
// ReturniA returns a type defined in version 1.0. 
ClassC.Return1A().Method1(); 
// ReturniB returns a type defined in version 2.0. 
ClassC.Return1B().Method1(); 
j 
j 





可 以 通过 以 下 方式 之 一 来 解决 这 个 错误 : 
e 更 新 代码 ， 以 便 所 有 DLL 文件 使 用 的 版 本 相同 。 
e 使 用 以 下 命令 编译 ， 把 对 DLL 2.0 版 的 引用 添加 到 d.cs CS1705: 


csc /reference:C:\CS1705.dll /reference:CS1705.dll /reference:CS1705c.dll 
CS1705d.cs 


虽然 使 用 此 命令 时 程序 在 编译 ， 则 在 不 运行 。 为 了 使 程序 在 运行 ， 则 可 提供 包 
含 使 用 <assemblyldentity> 和 <codeBase> 子 元 素来 指定 DLL1.0 版 本 位 置 的 


«dependentAssembly» 元 素 的 应 用 程序 配置 文件 。 有 关 配 置 文件 的 更 多 信 
息 ， 请 参见 使 用 配置 文件 配置 应 用 。 


请 参阅 
外 部 别名 (CH 参考 ) 
:: 运算 符 (CHE) 


Command-ine Building With csc.exe 


Compiler Error CS1708 


固定 大 小 的 缓冲 区 只 能 通过 局 部 变量 或 字段 访问 

CH 2.0 的 一 个 新 功能 是 能 够 在 struct 的 内 部 定义 内 艇 数组 。 这 类 数组 只 能 通过 局 
部 变量 或 字段 访问 ， 不 能 作为 表达 式 左 侧 的 中 间 值 被 引用 。 此 外 ， 这 些 数组 无 法 通 
过 static 或 readonly 的 字段 访问 。 

要 解决 此 错误 ， 请 定义 一 个 数组 变量 ， 然 后 将 内 绕 数 组 分 配给 该 变量 。 或 者 ， 从 表 
示 内 族 数 组 的 字段 中 移 除 static 或 readonly 修饰 符 。 


下 面 的 示例 生成 CS1708。 


// CS1708 .cs 
// compile with: /unsafe 
using System; 


unsafe public struct S 


{ 
public fixed char name[10]; 
} 
public unsafe class C 
{ 
public S UnsafeMethod() 
{ 
S myS = new S(); 
return myS; 
} 
static void Main() 
{ 
C myC = new C(); 
myC.UnsafeMethod().name[3] - 'a'; // CS1708 
// Uncomment the following 2 lines to resolve: 
// S myS = myC.UnsafeMethod( ); 
// myS.name[3] = 'a'; 
// The field cannot be static. 
C. s1.name[3] = 'a'; // CS1708 
// The field cannot be readonly. 
myC. s2.name[3] - 'a'; // CS1708 
} 


static readonly S  s1; 
public readonly S  s2; 
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Compiler Error CS1708 1299 


Compiler Error CS1716 
4 £f Fil*System.Runtime.CompilerServices.FixedBuffer"FrlE, if CAA fixed se ER 
修饰 符 。 


在 包含 与 字段 声明 相似 的 固定 大 小 的 数组 声明 的 不 安全 代码 段 中 ， 会 发 生 此 错误 。 
不 要 使 用 此 特性 。 请 改 用 关键 字 fixed。 


下 面 的 示例 生成 CS1716。 
// CS1716.cs 
// compile with: /unsafe 


using System; 
using System.Runtime.CompilerServices; 


public struct UnsafeStruct 


{ 
[FixedBuffer(typeof(int), 4)] // CS1716 
unsafe public int aField; 
// Use this single line instead of the above two lines. 
// unsafe public fixed int aField[4]; 
} 
public class TestUnsafe 
{ 


static int Main() 


UnsafeStruct us = new UnsafeStruct(); 
unsafe 
{ 
if (us.aField[0] == 0) 
return us.aField[1]; 
else 
return us.aField[2]; 


aif a5 $4 1x CS1721 


类 “class" 不 能 有 多 个 基 类 : "class 1"fl"class 2" 


导致 此 错误 的 最 常见 的 原因 是 党 试 使 用 多 重 继承 。 C# 中 的 类 只 能 从 一 个 类 直接 继 
A, 但 是 ， 类 可 以 实现 任意 数量 的 接口 。 


示例 
下 面 的 示例 演示 生成 SC1721 的 一 种 方式 ， 然 后 演示 避免 该 错误 的 两 种 可 行 方法 。 


// CS1721.cs 

public class A {} 

public class B {} 

public class MyClass : A, B {} // CS1721 


// One possible fix is to use the following approach instead: 
public class A {} 

public class B: A {} 

public class C : B {} 


// Another possible fix is to use interfaces instead of base classe 
public class A {} 

public interface B {} 

public class C : A, B tj 





参考 


多 态 性 (CH 编程 指南 ) 接口 (CH 编程 指南 ) 


Compiler Error CS1726 
友 元 程序 集 引 用 “reference” 无 效 。 强 名 称 签名 的 程序 集 必须 在 其 InternalsVisibleTo 
声明 中 指定 一 个 公 和 钥 。 


强 名 称 签 名 的 程序 集 只 能 将 使 用 InternalsVisibleToAttribute 创建 的 友 元 程序 集 访问 
权限 授予 其 他 强 签 名 的 程序 集 。 


若 要 解决 CS1726， 请 对 要 授予 其 友 元 访问 权限 的 程序 集 进行 签名 〈 赋 予 其 强 名 
WR) ， 或 不 授予 友 元 访问 权限 。 


有 关 更 多 信息 ， 请 参见 友 元 程序 集 (C# 和 Visual Basic) 。 
下 面 的 示例 生成 CS1726。 


// Save this code as CS1726.cs 


// Run the following command to create CS1726.key: 
// sn -k CS1726.key 


// Then compile by using the following command: 
// csc /keyfile:CS1726.key /target:library CS1726.cs 


using System.Runtime.CompilerServices; 


// The following line causes compiler error CS1726. 
[assembly: InternalsVisibleTo("UnsignedAssembly")] 


// To get rid of the error, try the following line instead. 
//[assembly: InternalsVisibleTo("SignedAssembly, PublicKey-0024000( 


class A ( } 





如 何 : 创建 签名 的 友 元 程序 集 (C# 和 Visual Basic) 


Compiler Error CS1729 


"type" Ta &3& "number SA 4438 HX 


TERS a] $68 FH EB 4pepg p, MRA ahna AAAA SAER 
造 画 数 ， 则 会 发 生 此 错误 。 在 下 面 的 示例 中 ，test 类 没有 采用 任意 参数 的 构造 画 
数 。 因 此 ， 该 类 只 有 不 含 参 数 的 默认 构造 画 数 。 由 于 在 生成 该 错误 的 第 二 行 上 ， 派 
生 类 没有 声明 其 自己 的 构造 男 数 ， 因 此 编译 器 将 提供 默认 构造 罚 数 。 该 构造 画 数 在 
基 类 中 调用 无 参数 构造 男 数 。 由 于 基 类 没有 此 类 构造 画 数 ， 因 此 会 生成 CS1729。 


更 正 此 错误 


1. 调整 构造 画 数 调用 中 的 参数 数量 。 
2. 修改 相应 的 类 ， 提 供 包 含 必须 调用 的 参数 的 构造 画 数 。 
3. 在 基 类 中 提供 无 参数 构造 画 数 。 

下 面 的 示例 生成 CS1729 : 


// cs1729.cs 
class Test 


{ 
static int Main() 
{ 
// Class Test has only a default constructor, which takes r 
Test testi - new Test(2); // CS1729 
// The following line resolves the error. 
Test test2 - new Test(); 
// Class Parent has only one constructor, which takes two : 
Parent exampleParenti = new Parent(10); // CS1729 
// The following line resolves the error. 
Parent exampleParent2 - new Parent(10, 1); 
return 1; 
} 
} 
public class Parent 
{ 
// The only constructor for this class has two parameters. 
public Parent(int i, int j) { } 
} 


// The following declaration causes a compiler error because class 
// does not have a constructor that takes no arguments. The declar: 
// class Child2 shows how to resolve this error. 

public class Child : Parent ( } // CS1729 


public class Child2 : Parent 


{ 
// The constructor for Child2 has only one parameter. To acces: 
// constructor in Parent, and prevent this compiler error, you 
// a value for the second parameter of Parent. The following e) 
public Child2(int k) 
base(k, 0) 
// Add the body of the constructor here. 
} 
} 





请 参阅 


继承 (CH 编程 指南 ) 
ISA (CH 编程 指南 ) 


Compiler Error CS1919 


创建 对 象 时 不 能 使 用 不 安全 的 类 型 “type name", 


new 运算 符 仅 在 托管 堆 上 创建 对 象 。 但 可 以 通过 使 用 语言 的 互 操作 功能 调用 返回 指 
针 的 本 机 方法 ， 间 接地 在 非 托管 内 存 中 创建 对 象 。 


更 正 此 错误 
1. 在 新 的 对 象 创 建 表 达 式 中 使 用 安全 类 型 。 例 如 ， 使 用 char 或 int， 而 不 是 使 用 
char* 或 int*。 


2. 如 果 必 须 在 非 托 管内 存 中 创建 对 象 ， 请 使 用 Win32 或 COM 方法 ， 或 者 用 C 
sk C++ 编写 自己 的 函数 并 从 CH HARB, 


下 面 的 示例 生成 CS1919， 因 为 指针 类 型 是 不 安全 的 : 


// cs1919.cs 
// Compile with: /unsafe 
unsafe public class C 


public static int Main() 


{ 
var coli = new int* ( }; // CS1919 
var col2 - new char* ( ); // CS1919 
return 1; 

} 


Án 


互 操作 性 (CH 编程 指南 ) 


Compiler Error CS1921 


与 "method" 最 匹配 的 重 载 方 法 具有 对 于 初始 值 设 定 项 元 素 而 言 错误 的 签名 。 可 初始 
化 的 Add 必须 是 可 访问 的 实例 方法 。 


在 尝试 对 没有 公共 非 静 态 Add 方法 的 类 使 用 集合 初始 值 设 定 项 时 ， 会 生成 此 错 
误 。 如 果 Add 方法 因 其 保护 级 别 (private, protected 和 internal) 而 不 可 访 
问 ， 则 会 收 到 CS0122， 因 此 该 错误 可 能 意味 着 该 方法 被 定义 为 static. 


下 面 的 示例 生成 CS1921 : 


// cs1921.cs 
using System.Collections; 
public class C : CollectionBase 


{ 
public static void Add(int 1) 


{ 
} 


public class Test 


public static void Main() 


{ 
} 


var collection = new C { 1, 2, 3 }; // CS1921 


请 参阅 


对 象 和 集合 初始 值 设 定 项 (CH 编程 指南 ) 


Compiler Error CS1926 


3 HX Win32 清单 文件 filename” 时 出 错 --"error", 
如 果 满 足以 下 条 件 ， 则 会 生成 此 错误 : 


1. 在 命名 行 上 或 通过 以 下 方法 指定 了 /win32manifest 选项 : 右 击 “ 解 决 方案 资源 
E np 指向 “添加 ”， 单 击 “ 新 建 项 ”， 然 后 单 击 “ 应 用 程序 清 
单 3] 


2. 该 文件 损坏 或 缺失 。 


更 正 此 错误 


1. 移 除 该 选项 。 

2. 蔡 换 、 修 复 或 重新 生成 该 文件 。 
在 使 用 损坏 的 win32 清单 文件 或 缺少 该 文件 的 情况 下 编译 时 ， 下 面 的 示例 会 生成 
CS1926 : 


// cs1926.cs 
// Compile with: /win32manifest: ../../app.manifest 
/7 CS1926 
class Test 
public static int Main() 


return 1; 


请 参阅 


/win32manifest (C# Compiler Options) 


Compiler Error CS1933 


表达 式 不 能 包含 查询 表达 式 
有 些 变量 不 能 用 查询 表达 式 进 行 初始 化 。 能 用 查询 表达 式 进行 初始 化 ， 因 为 
常量 只 能 用 文本 、 命 名 常量 和 到 学 aire -组 全 进行 初始 化 。 


更 正 此 错误 


1. 从 查询 变量 中 移 除 该 修饰 符 。 
下 面 的 示例 生成 CS1933 : 


// cs1933.cs 
using System.Ling; 
using System.Collections; 


class P 

{ 
const IEnumerable e = from x in new[] { 1, 2, 3 } select x; // 
static int Main() 


return 1; 





Compiler Error CS1936 


未 能 找到 源 类 型 “< 类 型 > 的 查询 模式 的 实现 。 方法 "未 找到 。 


为 了 查询 某 一 源 类 型 ， 该 类 型 必须 实现 要 在 查询 中 调用 的 标准 查询 运算 符 方法 。 该 
实现 可 以 采用 通过 适当 的 using 指令 放 和 范围 中 的 类 成 员 或 扩展 方法 的 形式 。 


更 正 此 错误 


e 请 确保 查询 的 是 对 象 集合 ， 而 不 是 单个 对 象 。 
e 请 确保 指定 了 所 需 using 指 兮 。 
下 面 的 示例 生成 CS1936 : 
// cs1936.cs 
using System.Collections; 


using System.Ling; 
class Test 


t 
static int Main() 
{ 
object obj; 
IEnumerable e = from x in obj // CS1936 
select x; 
return 0; 
} 
} 


如 果 无 意 中 党 试 查询 某 一 类 型 的 单个 对 象 而 不 是 此 类 对 象 的 集合 ， 则 通常 


错误 。 


请 参阅 


Standard Query Operators Overview 


会 发 生 此 


Compiler Error CS1941 


“clause" 子 句 中 一 个 表达 式 的 类 型 不 正确 。 类 型 推理 在 对 “method" 的 调用 中 失败 。 
查询 表达 式 中 的 类 型 推理 源 于 数据 源 中 的 元 素 类 型 。 


更 正 此 错误 
1. 如 果 发 生 此 错误 的 原因 不 十 分 明显 ， 请 仔细 检查 查询 ， 并 跟踪 从 数据 源 到 错误 
发 生 点 的 每 个 子 句 的 结果 的 类 型 。 
下 面 的 代码 生成 CS1941， 因 为 equals 运算 符 被 要 求 对 int 和 string 进行 比较 。 


// cs1941.cs 

using System.Collections; 
using System.Ling; 

class Test 


static int Main() 
var nums = new[] (1, 2, 3, 4, 5, 6 Y; 
var words = new string[] ( "lake", "mountain", "sky" }; 
IEnumerable e - from n in nums 
join w in words on n equals w // CS1941 


select w; 
return 0; 


发 生 类 型 推理 失败 的 方法 是 查询 子 句 在 编译 时 转换 为 的 方法 。 
请 参阅 


LINQ 查询 表达 式 (CH 编程 指南 ) 
Type Relationships in LINQ Query Operations (C#) 


Compiler Error CS1942 


“clause” 子 句 中 表达 式 的 类 型 不 正确 。 类 型 推理 在 对 “method” 的 调用 中 失败 。 
如 果 为 范围 变量 指定 了 不 正确 的 显 式 类 型 ， 通 常会 生成 此 错误 。 


更正 此 错误 


1. 如 果 范 围 变量 是 显 式 类 型 的 ， 请 确保 该 类 型 与 循环 访问 的 集合 中 的 元 素 类 型 相 
同 或 可 从 该 类 型 隐 式 转换 。 如 果 范 围 变 量 的 前 面 带 有 var 关键 字 ， 请 移 除 
var. 


下 面 的 代码 生成 CS1942 : 


// csi942.cs 
class Program 


{ 
static void Main(string[] args) 
{ 
var x = from var i in Enumerable.Range(1, 100) // CS19: 
select i; //CS1942 
} 
} 





CS1942 与 CS1949 相关 ， 因 为 对 范围 变量 使 用 var 会 导致 因 var 不 是 类 型 而 使 基 
础 Cast<T> 运算 失败 。 


请 参阅 
var (C# 参考 ) 
LINQ 查询 表达 式 (CH 编程 指南 ) 


Compiler Error CS1943 

在 具有 源 类 型 “type” 的 查询 表达 式 中 后 面 的 from 子 句 中 不 允许 使 用 类 型 为 “type” 的 
表达 式 。 类 型 推理 在 对 “method" 的 调用 中 失败 。 

所 有 范围 变量 都 必须 表示 可 查询 的 类 型 。 


更 正 此 错误 
1. 请 确保 该 类 型 是 实现 IEnumerable、IEnumerable<T> 或 派生 接口 的 可 查询 类 
型 ， 或 者 是 定义 了 查询 模式 的 任何 其 他 类 型 。 
2. 如 果 该 类 型 是 非 泛 型 IEnumerable， 请 在 范围 变量 上 提供 显 式 类 型 。 
下 面 的 代码 生成 CS1943 : 
// cs1943.cs 


using System.Ling; 
class Test 


{ 
class TestClass 
{ } 
static void Main() 
{ 


int[] nums = { ©, 1, 2, 3,4, 5}; 
TestClass tc = new TestClass(); 


var x = from n in nums 
from s in tc // CS1943 
select n+ s; 


Compiler Error CS1946 


无 法 将 匿名 方法 表达 式 转 换 为 表达 式 树 。 

匿名 方法 表示 一 组 语句 ， 而 表达 式 树 不 能 包含 任何 语句 。 因 此 ， 匿 名 方法 不 能 由 表 
达 式 树 表示 。 

更 正 此 错误 

1. 将 匿名 方法 更 改 为 lambda 表达 式 。 

下 面 的 示例 生成 CS1946 : 


// cs1946.cs 

using System; 
using System.Linq.Expressions; 
public delegate void D(); 


class Test 


1 
static void Main() 
{ 
Expression<D> tree = delegate() { }; //CS1946 
// Try using a lambda expression instead. 
// Expression<D> tree = (x) => x + 1; 
} 
} 
请 参阅 


匿名 方法 (C# 编程 指南 ) 
表达 式 树 (C# 和 Visual Basic) 


编译 个 错误 CS2032 


不 允许 命令 行 上 或 响应 文件 中 存在 字符 character 


csc.exe 的 命令 行 选项 和 响应 文件 不 允许 包含 0-31 范围 内 的 ASCI 码 控 制 字 符 或 者 
管道 ( | ) 字符 。 


编译 器 错误 CS2032 无 法 从 命令 行 演示 ， 因 为 命令 行 处 理 器 和 集成 开发 环境 (IDE) 

将 算 选 出 无 效 的 字符 。 使 用 响应 文件 ， 下 面 的 过 程 将 生成 错误 。 

生成 此 错误 

1. 在 我 的 文档 文件 夹 中 ， 创 建 一 个 名 为 CS2032 .rsp 的 文本 文件 ， 然 后 使 中 的 
以 下 编译 器 选项 : 


/target:exe /out:cs|2032.exe cs2032.cs 


2. 在 我 的 文档 文件 夹 中 ， 创 建 一 个 名 为 cs2032.cs， 其 中 包含 的 文本 文件 需要 的 
内 容 。 


3. 打开 “开始 ”、 然 后 选择 “所 有 程序 `、“Microsoft Visual Studio 2010", "Visual 
Studio 工具 ”， 然 后 单 击 “Microsoft Visual Studio 命令 提示 (2010)”。 


"Visual Studio 命 使 提 示 ” 窗 口 打 开 。 


4. 在 Visual Studio 命 令 行 提 示 窗 口中 ， 将 当前 的 目录 更 改 为 
C:AUsersWYourUsernameVX f, 


5. M'Visual Studio 命令 提示 "中 运行 以 下 命令 : csc @cs2032.rsp 


6. 因为 响应 文件 ，CS2032 .rsp， 出 现 CS2032 错误 信息 ， 其 中 包含 一 个 坚 
线 ， o 


Compiler Warning (level 1) CS0420 


"identifier" : 对 volatile 字段 的 引用 不 被 视 为 volatile 


volatile 字段 不 能 像 正 常情 况 那 样 使 用 ref 或 out 参数 进行 传递 ， 因 为 它 在 图 数 的 范 

围 内 不 会 被 视 为 volatile。 这 也 有 例外 情况 ， 例 如 当 调用 互 锁 API 时 。 对 于 任何 警 

告 ， 您 可 以 使 用 #pragma warning 在 您 特意 使 用 volatile 字段 作为 引用 参数 的 情况 
(这 种 情况 很 少 出 现 ) 中 禁用 此 警告 。 


下 面 的 示例 生成 CS0420 : 


// CS0420.cs 
// compile with: /W:1 
using System; 


class TestClass 


{ 


private volatile int i; 


public void TestVolatile(ref int ii) 
{ 
} 


public static void Main() 


TestClass x = new TestClass(); 
x.TestVolatile(ref x.i); // CS0420 
j 
j 


Compiler Warning (level 1) CS0465 


8| A"Finalize"75 E &fll sr AA ERSBU FH, ie S EB E AT A ERA? 
当 您 使 用 签名 为 public virtual void Finalize 的 方法 创建 类 时 ， 将 发 生 此 警告 。 


如 果 闻 这 种 类 用 作 基 类 并 且 派 生 类 定义 一 个 析 构 函数 ， 则 该 析 构 函数 籽 重 写 基 类 的 
Finalize 方法 ， 而 不 是 Finalize。 


下 面 的 示例 生成 CS0465。 


// CS0465.cs 
// compile with: /target:library 
class A 


public virtual void Finalize() (3 // CS0465 


// OK 
class B 


~B() {} 


Compiler Warning (level 1) CS1058 


前 一 个 catch 子 句 已 经 捕获 所 有 异常 。 引 发 的 所 有 异常 均 被 包装 在 
System.Runtime.CompilerServices.RuntimeWrappedException 中 


如 果 catch() 块 在 catch (System.Exception e) 块 后 没有 指定 的 异常 类 型 ， 则 该 特性 
会 导致 CS1058。 该 警告 建议 catch) 块 将 不 捕获 任何 异常 。 


如 果 在 AssemblyInfo.cs 文件 中 将 RuntimeCompatibilityAttribute 设置 为 

False， 则 catch (System.Exception e) 块 之 后 的 catch() 块 可 捕获 非 CLS 异常 : 
[assembly: RuntimeCompatibilityAttribute(WrapNonExceptionThrows = false)]。 如 
果 未 将 此 特性 显 式 设置 为 False， 则 所 有 引发 的 非 CLS 异常 将 包装 为 异常 ， 并 且 
catch (System.Exception e) 块 将 捕获 它们 。 有 关 更 多 信息 ， 请 参见 如 何 : 捕捉 非 
CLS 异常 。 


下 面 的 示例 生成 CS1058。 


// CS1058.cs 
// CS1058 expected 
using System.Runtime.CompilerServices; 


// the following attribute is set to true by default in the C4 com[ 
// set to false in your source code to resolve CS1058 
[assembly: RuntimeCompatibilityAttribute(WrapNonExceptionThrows - 1 


class TestClass 


l 


static void Main() 
{ 
try {} 


catch (System.Exception e) { 
System. Console.WriteLine("Caught exception {0}", e); 


j 


catch {} // CS1058N. This line will never be reached. 





Compiler Warning (level 1) CS1060 

使 用 了 可 能 未 赋值 的 字段 "name"。 如 果 结 构 未 赋值 ， 则 结构 实例 变量 在 初始 化 时 将 
不 被 赋值 。 

在 未 进行 显 式 初始 化 的 情况 下 ， 结 构成 员 将 初始 化 为 其 默认 值 。 类 类 型 (及 其 他 引 
用 类 型 ) 的 默认 值 为 null。 如 果 在 没有 对 类 进行 初始 化 的 情况 下 就 尝试 访问 它 ， 则 
会 在 运行 时 引发 NullReferenceException。 编 译 器 无 法 最 终 确定 类 成 员 是 否 将 进 
行 初始 化 ， 因 此 CS1060 是 警告 而 不 是 错误 。 


更 正 此 错误 
1. 为 struct 提供 一 个 初始 化 其 所 有 成 员 的 构造 函数 。 
下 面 的 代码 生成 CS1060， 因 为 类 类 型 U 是 struct S 的 成 员 但 从 未 初始 化 。 


// cs1060.cs 
namespace CS1060 


{ 
public class U 
{ 
public int i; 
} 
public struct S 
{ 
public U u; 
// Add constructor to correct the error. 
//public S(int val) 
/AL 
// u = new U() { i = val }; 
//} 
public class Test 
{ 
static void Main() 
1 
SES 
s.u.i = 5; // CS1060 
//Try these lines instead, and uncomment the construct: 
// S s - new S(0); 
// Sci = 5; 
} 
} 
} 





请 参阅 


结构 (CH 编程 指南 ) 


Compiler Warning (level 1) CS1598 


未 能 加 载 XML 分 析 器 ， 原 因 如 下 : “< 原因 >”。 将 不 生成 XML 文档 文件 "< 文件 > 。 


指定 了 /doc 选项 ， 但 编译 器 未 能 找到 并 加 载 msxml3.dll。 请 确保 msxml3.dll 文件 
已 安装 并 注册 。 


Compiler Warning (level 1) CS1607 


程序 集 生 成 — reason 
在 编译 的 程序 集 创 建 阶段 生成 了 警告 。 


如 果 要 在 32 位 操作 系统 上 生成 一 个 64 位 应 用 程序 ， 必 须 确 保 在 目标 操作 系统 上 安 
装 了 所 有 引用 的 程序 集 的 64 位 版 本 。 


所 有 特定 于 x86 的 公共 语言 运行 时 (CLR) 程序 集 都 具有 64 位 的 对 应 项 (每 个 CLR 
程序 集 都 存在 于 所 有 操作 系统 上 ) 。 因 此 ， 对 于 CLR 程序 集 可 以 放心 地 忽略 
CS1607。 


如 果 在 创建 AssemblyInformationalVersionAttribute 时 遇 到 此 警告 ， 则 可 忽略 此 警 
告 。 信 息 性 版 本 是 一 个 字符 串 ， 它 将 附加 的 版 本 信息 附加 到 一 个 程序 集 ; 此 信息 不 
在 运行 时 使 用 。 虽 然 可 以 指定 任意 文本 ， 但 是 如 果 字 符 串 的 格式 不 是 程序 集 版 本 号 
使 用 的 格式 ， 或 者 虽然 是 这 种 格式 但 包含 通配符 ， 则 在 编译 时 会 显示 一 条 警告 消 


息 。 此 警告 无 碍 。 


有 关 更 多 信息 ， 请 参见 Alexe 工具 错误 和 和 警告 。 


Compiler Warning (level 1) CS1616 


选项 “option" 重 宇 源 文件 或 附加 模块 中 给 出 的 特性 “attribute” 


如 果 源 文件 中 的 程序 集 特 性 AssemblyKeyFileAttribute 或 
AssemblyKeyNameAttribute 与 项 目 属 性 中 指定 的 /keyfile 或 /keycontainer $5 4517 
选项 或 密 钥 文 件 名 或 密 钥 容 器 冲突 ， 则 会 出 现 此 警告 。 


E He 假定 您 有 一 个 名 为 cs1616.snk 的 密 钥 文件 。 该 文件 可 以 用 命 兮 
行 生 成 : 


sn -k CS1616.snk 


下 面 的 示例 生成 CS1616 : 


// CS1616.cs 
// compile with: /keyfile:cs1616.snk 
using System.Reflection; 


// To fix the error, remove the next line 
[assembly: AssemblyKeyFile("csi616b.snk")] // CS1616 


class C 


public static void Main() 
t 
} 

} 


Compiler Warning (level 1) CS1658 


“warning text”, 另 请 参见 错误 “error code" 


编译 器 在 用 警告 重 写 错误 时 会 发 出 此 和 警告。 有 关 此 问题 的 信息 ， 请 参考 上 面 所 提 到 
的 错误 。 若 要 从 Visual Studio IDE 内 查找 相应 的 错误 ， 请 使 用 索引 。 例 如 ， 如 果 上 
面 的 文本 是 “ 另 请 参见 错误 'CS1037”， 则 请 在 索引 中 查找 CS1037。 


下 面 的 示例 生成 CS1658。 


// CS1658.cs 

// compile with: /doc:x.xml 

// CS1584 expected 

/// «summary» 

/// </summary> 

public class C 

{ 
/// «see cref="C.F(params object[])"/> // CS1658 
public static void M() 
{ 
} 


/// <summary> 

/// </summary> 

public void F(params object[] o) 
t 

} 


static void Main() 
{ 
} 


Compiler Warning (level 1) CS1683 


对 类 型 "Type Name” 的 引用 声称 在 此 程序 集中 定义 了 该 类 型 ， 但 源 代码 或 任何 添加 
的 模块 中 并 未 定义 该 类 型 


当 您 导入 的 程序 集 反 过 来 包含 对 您 当前 正在 编译 的 程序 集 的 引用 ， 而 正在 编译 的 程 
序 集 不 包含 任何 与 该 引用 匹配 的 内 容 时 ， 会 出 现 此 错误 。 导 致 此 情况 的 一 种 操作 
是 ， 编 译 您 的 程序 集 ， 它 最 初 确实 包含 所 导 人 的 程序 集 引 用 的 成 员 。 然 后 更 新 您 的 
程序 集 ， 不 小 心 移 除了 导入 的 程序 集 所 引用 的 成 员 。 


Compiler Warning (level 1) CS1685 


预定 义 类 型 "System.type name" 是 在 全 局 别名 的 多 个 程序 集中 定义 的 ; 请 使 用 “文件 
名 ”中 的 定义 

当 在 两 个 程序 集中 都 找到 一 个 预定 义 系统 类 型 (例如 System.int32) 时 ， 会 出 现 此 
错误 。 如 果 您 从 两 个 不 同 的 位 置 引 用 mscorlib (例如 尝试 并 列 运 行 1.0 和 1.1 版 的 
.NET Framework) ， 会 发 生 此 错误 。 

编译 器 仅 使 用 其 中 一 个 程序 集中 的 定义 。 编 译 器 只 搜索 全 局 别名 ， 不 搜索 定义 
/reference 的 库 。 如 果 您 指定 了 /nostdlib， 编 译 器 将 搜索 Object， 并 且 以 后 所 有 
预定 义 类 型 的 搜索 都 将 在 包含 Object 的 文件 中 进行 。 


Compiler Warning (level 1) CS1690 


由 于 “member" 是 引用 封 送 类 的 字段 ， 访 问 上 面 的 成 员 可 能 导致 运行 时 异常 


当 您 党 试 对 从 MarshalByRefObject 派生 的 类 成 员 调 用 方法 、 属 性 或 索引 器 时 ， 并 
且 该 成 员 是 值 类 型 时 ， 会 出 现 此 警告 。 从 MarshalByRefObject 继承 的 对 象 通常 应 
由 跨 上 应 用 程序 域 的 引用 进行 封 送 。 如 果 任 何 代 码 鲁 经 尝试 跨 应 用 程序 域 直接 访问 的 
此 类 对 象 的 值 类 型 成 员 ， 则 会 发 生 运行 时 异常 。 若 要 解决 此 警告 ， 请 先 将 该 成 员 复 
制 到 局 部 变量 并 对 该 变量 调用 方法 。 


下 面 的 示例 生成 CS1690 : 


// CS1690.cs 
using System; 


class WarningCS1690: MarshalByRefObject 
{ 


int i = 5; 


public static void Main() 

{ 
WarningCS1690 e = new WarningCS1690(); 
e.i.ToString(); // CS1690 


// OK 

int i = e.i; 
i.ToString(); 
e.i = i; 


Compiler Warning (level 1) CS1691 


“number 不 是 有 效 的 警告 编号 


传递 给 #pragma warning 预 处 理 器 指令 的 数字 不 是 有 效 的 警告 编号 。 请 验证 该 数字 
表示 和 警告， 而 不 是 错误 或 其 他 字符 序列 。 


下 面 的 示例 生成 CS1691。 


// CS1691.cs 
public class C 
í . . 
int 1 = 1; 
public static void Main() 


{ 

C myC = new C(); 
#pragma warning disable 151 // CS1691 
// Try the following line instead: 
// #pragma warning disable 1645 

myC. i++; 
#pragma warning restore 151 // CS1691 
// Try the following line instead: 
// #pragma warning restore 1645 


} 
} 


Compiler Warning (level 1) CS1699 


使 用 命 合 行 选项 "compiler_option” 或 适当 项 目 设 置 代替 “attribute_name” 
为 给 程序 集 签 名 ， 必 须 指定 密 钥 文件 。 在 Microsoft Visual C# 2005 之 前 ， 您 在 源 
代码 中 使 用 CLR 特性 指定 了 密 钥 文件 。 现 在 ， 这 些 特性 都 被 否决 了 。 


从 Microsoft Visual C# 2005 开始 ， 您 应 使 用 “项 目 设计 器 ”的 “签名 页 ”或 程序 集 链 
接 器 指定 密 钥 文件 。 


“项 目 设 计 器 ”的 “签名 页 ”是 首选 方法 ; 有 关 更 多 信息 ， 请 参见 “项 目 设 计 器 "->" 签 
名 "页 和 管理 程序 集 签名 和 清单 签名 。 


如 何 : 使 用 强 名 称 为 程序 集 签 名 使 用 如 下 编译 器 选项 : 
e /keyfile (C# Compiler Options) 代替 AssemblyKeyFileAttribute 特性 。 
e /keycontainer (C£ Compiler Options) 而 不 是 AssemblyKeyNameAttribute。 
e /delaysign (C£ Compiler Options) 代替 AssemblyDelaySignAttribute, 
否决 这 些 特性 的 原因 是 : 


e 存在 安全 问题 ， 因 为 这 些 特性 做 入 在 由 编译 器 生成 的 二 进 制 文件 中 。 因 此 ， 每 
个 拥有 您 的 二 进 制 文件 的 人 都 会 获得 存储 在 其 中 的 密 钥 。 


存在 可 用 性 问题 ， 因 为 特性 中 指定 的 路 径 是 相对 于 当前 工作 目录 (此 目录 在 集 
成 开发 环境 (IDE) 中 可 能 会 发 生 更 改 ) 或 输出 目录 的 。 因 此 ， 大 多 数 情况 下 密 
钥 文 件 有 可 能 是 ..\..\mykey.snk。 特 性 还 增加 了 项 目 系统 为 附属 程序 集 正确 签名 
的 难度 。 当 您 使 用 编译 器 选项 代替 这 些 特 性 时 ， 可 以 使 用 密 钥 的 完全 限定 路 径 
和 文件 名 ， 而 无 需 在 输出 文件 中 艇 入 任何 内 容 ; 项 目 系 统 和 源 代 码 管 理 系 统 可 
在 项 目 移 动 时 正确 处 理 该 完整 路 径 ; 项 目 系 统 可 保留 密 钥 文件 的 项 目 相 对 路 

径 ， 同 时 仍 将 完整 路 径 传 递 给 编译 器 ; 其 他 生成 程序 可 通过 直接 将 适当 的 路 径 
传递 给 编译 器 (而 不 是 用 正确 的 特性 生成 源 文件 ) 更 加 容易 地 为 输出 签名 。 


将 特性 用 于 友 元 程序 集会 影响 编译 器 的 效率 。 当 您 使 用 特性 时 ， 编 译 器 在 必须 
决定 是 否 授予 友 元 关系 时 不 知道 密 钥 是 什么 ， 因 此 它 必 须 进 行 推测 。 在 编译 的 
最 后 ， 一 旦 编译 器 最 后 知道 了 密 钥 ， 它 就 能 够 对 推测 进行 验证 。 当 使 用 编译 器 
选项 指定 密 钥 文件 时 ， 编 译 器 可 立即 决定 是 否 授 予 友 元 关系 。 


下 面 的 示例 生成 CS1699。 若 要 解决 此 错误 ， 请 移 除 该 特性 并 使 用 /delaysign 进行 
编译 。 


// CS1699.cs 
// compile with: /target:library 
[assembly:System.Reflection.AssemblyDelaySign(true)] // CS1699 
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请 参阅 

“项 目 设计 器 "->" 签 名 "页 

管理 程序 集 签名 和 清单 签名 
如 何 : 使 用 强 名称 为 程序 集 签名 


Compiler Warning (level 1) CS1699 


1329 


Compiler Warning (level 1) CS1762 


RIAM <assembly2>' 间 接 引 用 了 程序 集 '<assembly1>'， 一 个 引用 将 被 创建 并 
入 到 互 操 作 程序 集 assembly1 中 .请 考虑 更 改 任 一 程序 集 的 “ 树 入 互 操作 类 型 " 属 


o 


您 已 添加 了 一 个 对 Embed Interop Types 属性 设置 为 True 的 程序 集 (assembly1) 
的 引用 。 这 将 指示 编译 器 对 人 该 程序 集中 的 互 操作 类 型 信息 。 但 是 ， 编 译 器 无 法 旋 
入 该 程序 集中 的 互 操作 类 型 信息 因为 您 已 引用 的 另 一 个 程序 集 (assembly2) 也 引 
用 了 该 程序 集 (assembly1) 并 且 它 的 Embed Interop Types 属性 设置 为 False。 


Mo = 
Ef TERR 


将 某 个 程序 集 引 用 的 Embed Interop Types 属性 设置 为 True 相当 于 通过 使 用 
命令 行 编译 器 的 /link 选项 来 引用 该 程序 集 。 


处 理 此 警告 
e 若 要 财 入 这 两 个 程序 集 的 互 操作 类 型 信息 ， 请 将 对 assembly1 的 所 有 引用 的 


Embed Imi nterop Types 属性 设置 为 True。 有 关 如 何 设 受 置 此 属性 的 更 多 信息 ， 
参见 演练 : 做 入 托管 程序 集中 的 类 型 (C£ 和 Visual Basic) 。 


e 若 要 移 除 此 警告 ， 您 可 以 闻 assembly 的 Embed Interop Types 属性 设 
False。 在 这 种 情况 下 ， 互 操作 类 型 信息 由 主 互 操作 程序 集 (PIA) 提供 。 


请 参阅 
link (C£ Compiler Options) 


Programming with Primary Interop Assemblies 


Compiler Warning (level 1) CS1956 
成 员 “"name” 实 现 类 型 “type” 中 的 接口 成 员 “name”。 在 运行 时 有 多 个 与 该 接口 成 员 相 
匹配 的 项 。 将 调用 哪个 方法 取决 于 具体 的 实现 。 


如 果 两 个 接口 方法 的 唯一 区 别 在 于 : 某 个 特定 参数 被 ref 还 是 out 标 记 ， 则 将 生成 此 
警告 。 最 好 更 改 代 码 以 避免 此 警告 ， 因 为 在 运行 时 实际 将 调用 哪个 方法 并 不 十 分 明 
或 者 无 法 保证 在 运行 时 将 调用 哪个 方法 。 


E, 
尽管 C# 可 以 区 分 t 和 ref, CLR 却 无 法 区 分 它们 。 决 定 实现 接口 的 方法 时 ， 
LR 只 是 从 中 任 选 一 


避免 此 警告 
1. 为 编译 器 提供 某 种 方式 来 区 分 这 两 个 方法 。 例 如 ， 可 以 为 这 两 个 方法 提供 不 
的 名 称 ， 或 者 为 其 中 一 个 方法 提供 附加 参数 。 


下 面 的 代码 将 生成 CS1956， 因 为 Base 中 这 两 个 Test 方法 的 唯一 区 别 在 于 它们 的 
第 一 个 参数 上 的 ref/out 修饰 符 : 


// cs1956 .cs 
class Base<T, S» 


{ 
// This is the method that should be called. 
public virtual int Test(out T x) // CS1956 
{ 
x = default(T); 
return 0; 
} 
// This is the "last" method and is the one that ends up being 
public virtual int Test(ref S x) 
{ 
return 1; 
} 
} 
interface IFace 
{ 
int Test(out int x); 
} 
class Derived : Base<int, int>, IFace 
{ 
static int Main() 
{ 
IFace x = new Derived(); 
int y; 
return x.Test(out y); 
} 





Compiler Warning (level 1) CS3003 


“变量 "的 类 型 不 符合 CLS 


public, protected 或 protected internal 变量 的 类 型 必须 符合 公共 语言 规范 
(CLS) AX CLS 遵从 性 的 详细 信息 ， 请 参阅 语言 独立 性 和 和 与 语言 无 天 的 组 件 。 


下 面 的 示例 生成 CS3003 : 


// CS3003.cs 


[assembly:System.CLSCompliant(true)] 
public class a 


public ushort a1; // CS3003, public variable 
public static void Main() 

{ 

} 


Compiler Warning (level 1) CS3007 


只 是 未 命名 数组 类 型 不 同 的 重 载 方法 "method "不 符合 CLS。 


如 果 你 有 一 个 接受 交错 数组 的 重 载 方法 ， 并 且 方 法 签名 的 唯一 区 别 是 数组 的 元 素 类 
型 ， 则 将 发 生 此 错误 。 为 避免 此 错误 ， 可 考虑 使 用 矩形 数组 而 不 是 交错 数组 ， 使 用 
一 个 额外 的 参数 消除 函数 调用 的 歧义 ， 重 命名 一 个 或 多 个 重 裁 方法 ， 或 者 如 果 不 需 
要 CLS 遵从 性 ， 则 移 除 CLSCompliantAttribute 特性 。 有 关 CLS 遵从 性 的 详细 信 
息 ， 请 参阅 语言 独立 性 和 和 与 语言 无 关 的 组 件 。 


下 面 的 示例 生成 CS3007 : 


// CS3007 .cs 
[assembly: System.CLSCompliant(true)] 
public struct S 


public void F(int[][] array) { } 

public void F(byte[][] array) { } // CS3007 
// Try this instead: 

// public void Fi(int[][] array) (3 

// public void F2(byte[][] array) 13 

// or 

// public void F(int[,] array) {} 

// public void F(byte[,] array) (3 


Compiler Warning (level 1) CS3009 


"type" : 基 类 型 "type" 不 符合 CLS 

在 标记 为 符合 公共 语言 规范 (CLS) 的 程序 集中 ， 基 类 型 被 标记 为 不 必 符 合 CLS。 请 
移 除 指定 程序 集 符合 CLS 的 特性 ， 或 移 除 指示 类 型 不 符合 CLS 的 特性 。 有 关 CLS 
遵从 性 的 更 多 信息 ， 请 参见 编写 符合 CL 的 代码 和 话 言 独立 性 和 和 与 语言 无 关 的 组 
件 。 


下 面 的 示例 生成 CS3009 : 


// CS3009.cs 

using System; 
[assembly:CLSCompliant(true)] 
[CLSCompliant(false)] 

public class B 


t 
} 


public class C : B // CS3009 


public static void Main () {} 


编译 器 警告 《等 级 1) CS4014 


由 于 此 调用 不 会 等 待 ， 因 此 在 调用 完成 前 将 继续 执行 当前 方法 。 请 考虑 将 “await" 运 
算 符 应 用 于 调用 结果 。 


当前 方法 调用 返回 Task 或 Task<TResult>， 而 不 应 用 运算 符 等 候 到 结果 的 异步 方 
法 。 异 步 方 法 的 调用 启动 异步 任务 。 但 是 ， 因 为 await 运算 符 没有 应 用 ， 程 序 继续 
运行 ， 而 不 必 等 待 任务 完成 。 在 大 多 数 情况 下 ， 此 行为 不 是 您 所 期 望 的 。 通 常 调用 
方法 的 其 他 特性 取决 于 调用 的 结果 ， 或 最 低 限 度 上 ， 调 用 方法 的 预计 在 从 包含 调用 
的 方法 返回 之 前 完成 。 


同样 至 关 重 要 的 问题 是 被 调用 的 异步 方法 中 引发 的 异常 发 生 了 什么 。 在 返回 Task 或 
Task<TResult> 方 法 中 引发 的 异常 被 存储 在 返回 的 任务 中 。 如 果 不 等 待 任务 还 不 
式 检查 异常 ， 该 异常 会 丢失 。 如 果 在 等 待 任务 ， 异 常会 被 重新 抛 出 。 
作为 最 佳 做 法 ， 应 始终 在 等 待 调用 。 


应 考虑 禁止 显示 警告 ， 仅 当 您 确定 不 希望 等 待 异步 调用 完成 并 且 这 个 被 调用 的 方法 
不 会 引发 任何 异常 。 在 此 情况 下 ， 可 以 通过 分 配 调用 的 任务 结果 给 变量 来 禁止 警 


+e 
Flo 


下 面 的 示例 演示 如 何 生成 警告 ， 如 何 显 示 它 以 及 如 何等 待 调用 。 


async Task CallingMethodAsync() 


( 


} 


resultsTextBox.Text += "\r\n Entering calling method."; 

// Nariable delay is used to slow down the called method so th: 
// distinguish between awaiting and not awaiting in the prograr 
// You can adjust the value to produce the output that this to[ 
// after the code. 

var delay - 5000; 


// Call #1. 

// Call an async method. Because you don't await it, its compl: 
// isn't coordinated with the current method, CallingMethodAsyr 
// The following line causes warning CS4014. 
CalledMethodAsync(delay); 


// Call #2. 

// To suppress the warning without awaiting, you can assign the 
// returned task to a variable. The assignment doesn't change ł 
// the program runs. However, recommended practice is always t¢ 
// await a call to an async method. 


// Replace Call #1 with the following line. 
//Task delayTask - CalledMethodAsync(delay); 


// Call £3 

// To contrast with an awaited call, replace the unawaited cal. 
// (Call #1 or Call #2) with the following awaited call. Best 
// practice is to await the call. 


//await CalledMethodAsync(delay); 


// If the call to CalledMethodAsync isn't awaited, CallingMethc 
// continues to run and, in this example, finishes its work anc 
// to its caller. 

resultsTextBox.Text += "\r\n Returning from calling method."; 


async Task CalledMethodAsync(int howLong) 


( 


resultsTextBox.Text += 
"\r\n Entering called method, starting and awaiting Tasl 


// Slow the process down a little so that you can distinguish I 
// awaiting and not awaiting in the program's output. Adjust tl 
// for howLong if necessary. 
await Task.Delay(howLong); 
resultsTextBox.Text += 

"\r\n Task.Delay is finished--returning from called mett 


T 








在 此 示例 中 ， 如 果 您 调用 Call #1 或 Call #2， 在 调用 方 (CallingMethodAsync) 和 调 
用 方 的 调用 方 (startButton_Click) 完成 后 ， 不 等 待 异步 方法 (CalledMethodAsync) 
o 当 调 用 的 方法 完成 时 ， 以 下 输出 的 最 后 一 行 向 你 演示 了 。 从 在 完整 的 示例 中 调用 
CallingMethodAsync 的 事件 处 理 程序 ， 为 输入 和 输出 做 标记 。 


Entering the Click event handler. 
Entering calling method. 
Entering called method, starting and awaiting Task.Delay. 


Returning from calling method. 
Exiting the Click event handler. 
Task.Delay is finished--returning from called method. 


使 用 #pragma warning (C£ 参考 ) 指令 ， 还 可 以 取消 编译 器 警告 。 


以 下 Windows Presentation Foundation (WPF) 应 用 程序 包含 从 前 面 的 方法 。 下 列 
步骤 建立 应 用 程序 。 


1. 创建 WPF 应 用 程序 ， 将 其 命名 为 AsyncWarning。 
2. f£ Visual Studio 代码 编辑 器 中 ， 选 择 "MainWindow.xamf 选 项 卡 。 


如 果 此 选项 卡 不 可 视 ， 则 在 “解决 方案 资源 管理 器 "中 ， 打 开 MainWindow.xaml 
的 快捷 菜单 ， 然 后 选择 “查看 代码 ” 


3. 在 MainWindow.xaml 的 “XAML” 视 图 中 ， 使 用 下 面 的 代码 替换 代码 。 


&lt;Window x:Class-"AsyncWarning.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/pre 
xmlns:xz"http://schemas.microsoft.com/winfx/2006/xaml" 
Title-"MainWindow" Height="350" Width="525"&gt; 

&lt;Grid&gt; 
&lt;Button x:Name="StartButton" Content="Start" Horizor 
&lt;TextBox x:Name="resultsTextBox" Margin="0,80,0,0" T 
&lt;/Grid&gt; 
&lt;/Window&gt; 


包含 按钮 和 文本 框 的 简单 窗口 显示 在 MainWindow.xaml 的 “设计 ”窗口 中 。 


有 关 XAML 设 计 器 的 更 多 信息 ， 请 参见 在 Visual Studio 中 ， 使 用 XAML 设计 
器 创建 Ul。 有 关 如 何 生 成 自己 的 简单 的 UI， 请 参见 演练 : 使 用 Async 和 
Await 访问 Web (C# 和 Visual Basic) 的 “创建 WPF 应 用 程序 "和 “设计 的 简单 
WPF MainWindow” 一 节 。 


4. 将 MainWindow.xaml.cs 中 的 代码 替换 为 以 下 代码 。 





using System; 
using System.Collections.Generic; 


using 
using 
using 
using 
using 
using 
using 
using 
using 
using 
using 
using 


System.Ling; 

System.Text; 
System.Threading.Tasks; 
System.Windows; 
System.Windows.Controls; 
System.Windows.Data; 
System.Windows.Documents; 
System.Windows. Input; 
System.Windows.Media; 
System.Windows.Media.Imaging; 
System.Windows.Navigation; 
System.Windows.Shapes; 


namespace AsyncWarning 


£ 


public partial class MainWindow : Window 


( 


public MainWindow( ) 


{ 
} 


InitializeComponent(); 


private async void startButton Click(object sender, Rot 


( 


j 


resultsTextBox.Text += "\r\nEntering the Click ever 
await CallingMethodAsync(); 
resultsTextBox.Text += "\r\nExiting the Click event 


async Task CallingMethodAsync() 


i 


resultsTextBox.Text += "\r\n Entering calling metr 
// Nariable delay is used to slow down the called n 
// distinguish between awaiting and not awaiting ir 
// You can adjust the value to produce the output t 
// after the code. 
var delay - 5000; 


// Call #1. 

// Call an async method. Because you don't await it 
// isn't coordinated with the current method, Calli 
// The following line causes warning CS4014. 
CalledMethodAsync(delay); 


// Call #2. 

// To suppress the warning without awaiting, you ce 
// returned task to a variable. The assignment does 
// the program runs. However, recommended practice 
// await a call to an async method. 


// Replace Call #1 with the following line. 
//Task delayTask - CalledMethodAsync(delay); 


// Call #3 

// To contrast with an awaited call, replace the ur 
// (Call #1 or Call #2) with the following awaited 
// practice is to await the call. 


//await CalledMethodAsync(delay); 


// If the call to CalledMethodAsync isn't awaited, 

// continues to run and, in this example, finishes 

// to its caller. 

resultsTextBox.Text += "\r\n Returning from callir 


} 


async Task CalledMethodAsync(int howLong) 
t 
resultsTextBox.Text += 
"\r\n Entering called method, starting and e 


// Slow the process down a little so that you can c 
// awaiting and not awaiting in the program's output 
// for howLong if necessary. 
await Task.Delay(howLong); 
resultsTextBox.Text += 

"NrNn Task.Delay is finished--returning fron 


// Output with Call #1 or Call #2\. (Wait for the last line 


// Entering the Click event handler. 

// Entering calling method. 

// Entering called method, starting and awaiting Task.EL 
// Returning from calling method. 

// Exiting the Click event handler. 

// Task.Delay is finished--returning from called methoc 


// Output with Call #3, which awaits the call to CalledMett 


// Entering the Click event handler. 

// Entering calling method. 

£7 Entering called method, starting and awaiting Task.EL 
// Task.Delay is finished--returning from called methoc 
// Returning from calling method. 

// Exiting the Click event handler. 





5. 选择 F5 键 运行 程序 ， 然 后 选择 "开始 "按钮 。 
预期 的 输出 显示 在 代码 结尾 。 
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请 参阅 
await (C# 参考 ) 
使 用 Async 和 Await 的 异步 编程 (C# 和 Visual Basic) 


编译 器 警告 (等 级 1) CS4014 1341 


Compiler Warning (level 2) CS0108 


“member1” 会 隐藏 继承 的 成 员 “member2”。 如 果 打 算 隐 藏 ， 请 使 用 new 关键 字 。 


声明 变量 所 使 用 的 名 称 与 基 类 中 的 变量 相同 。 但 没有 使 用 new 关键 字 。 此 警告 通知 
您 应 使 用 new ; 声明 变量 时 将 按 已 在 声明 中 使 用 了 new 来 义理 。 


下 面 的 示例 生成 CS0108 : 
// CS0108.cs 


// compile with: /W:2 
using System; 


namespace x 
public class clx 


public int i - 1; 


j 


public class cly : clx 

1 
public static int i - 2; // CS0108, use the new keyword 
// Use the following line instead: 
// public static new int i - 2; 


public static void Main() 


{ 
Console.WriteLine(i); 
} 
} 
} 
请 参阅 


new 修饰 符 (CH 参考 ) 


new 


编译 器 警告 (等 级 2) CS0467 


方法 “method”" 和 非 方 法 “non-method" 之 间 存 在 多 义 性 。 正 在 使 用 方法 组 。 
如 果 继 承 的 成 员 具 有 相同 的 签名 ， 但 来 自 不 同 的 接口 ， 则 会 导致 多 义 性 错误 。 
下 面 的 示例 会 产生 CS0467。 


// CSo467 .cs 
interface IList 


1 
int Count { get; set; } 
j 
interface ICounter 
{ 
void Count(int i); 
} 


interface IListCounter : IList, ICounter {} 


class Driver 


{ 

void Test(IListCounter x) 

{ 
// The following line causes the warning. The assignment a. 
// causes an error because you can't assign a value to a me 
x.Count - 1; 
x.Count(3); 
// To resolve the warning, you can change the name of ther 
// the property. 
// You also can disambiguate by specifying IList or ICounte 
((IList)x).Count - 1; 
((ICounter)x).Count(3); 

} 

static void Main() 

{ 

} 





Compiler Warning (level 2) CS0618 


“member’ 已 过 时 : "text" 


类 成 员 是 用 Obsolete 特性 标记 的 ， 以 致 在 引用 该 类 成 员 时 会 发 出 警告 。 有 关 更 多 
信息 ， 请 参见 常用 特性 (C# Al Visual Basic) 。 


下 面 的 示例 生成 CS0618 : 


// CS0618.cs 
// compile with: /W:2 
using System; 


public class C 


( 


[Obsolete("Use newMethod instead", false)] // warn if referent 
public static void m2() 


{ 
} 


public static void newMethod() 


t 
j 
} 


class MyClass 


public static void Main() 


C.m2(); // CS0618 





Compiler Warning (level 2) CS1701 


假定 程序 集 引 用 “Assembly Name #1”5“Assembly Name #2” 匹 配 ， 您 可 能 需要 提 
供 运行 时 策略 


这 两 个 程序 集 在 发 行 号 和 /或 版 本 号 上 有 差异 。 为 保证 一 致 ， 必 须 在 应 用 程序 的 
config 文件 中 指定 指令 ， 并 提供 程序 集 的 正确 强 名 称 ， 如 以 下 代码 示例 所 示 。 


下 面 的 多 文件 示例 使 用 两 个 不 同 的 外 部 别名 引用 一 个 程序 集 。 第 一 个 示例 生成 用 于 
创建 程序 集 CS1701_d 的 代码 的 较 早 版 本 。 


// CS1701 a.cs 
// compile with: /target:library /out:cs1701 d.dll /keyfile:mykey.: 
using System.Reflection; 
[assembly:AssemblyVersion("1.0")] 
public class A ( 
public void M1() {} 


public class C1 {} 
LL E 


这 是 用 于 创建 较 新 版 本 的 程序 集 CS1701 d 的 代码 。 注 意 ， 由 于 这 两 个 版 本 的 输出 
文件 同名 ， 因 此 它 需 要 将 较 新 版 本 编译 到 不 同 于 较 早 版 本 的 目录 中 。 





// CS1701_b.cs 
// compile with: /target:library /out:c:NNcs1701 d.dll /keyfile:myl 
using System.Reflection; 
[assembly:AssemblyVersion("2.0")] 
public class A ( 
public void M2() {} 
public void M1() {} 
} 


public class C2 {} 
public class C1 {} 


EE 


此 示例 设置 外 部 别名 A1 和 A2, 





// CS1701_¢-cs 
// compile with: /target:library /reference:A2-c:NNcs1701 d.dll /rt 


extern alias A1; 
extern alias A2; 
// using System; 
using al = A1::A; 
using a2 - A2::A; 


public class Ref ( 

public static ai A1() { return new ai1(); } 

public static a2 A2() { return new a2(); } 
public static A1::C1 M1() { return new A1::C1(); } 
public static A2::C2 M2() { return new A2::C2(); } 





天 Eee 
此 示例 使 用 A 的 两 个 不 同 别名 调用 方法 。 下 面 的 示例 生成 C1701。 


// CS1701_d.cs 
// compile with: /reference:c:NNCS1701 d.dll /reference:CS1701_c.d. 
// CS1701 expected 
class Tester ( 
public static void Main() ( 
Ref.A1().M1(); 
Ref.A2().M2(); 





Compiler Warning (level 3) CS0675 
按 位 "或 "运算 符 在 带 符号 扩展 操作 数 上 使 用 ; 请 考虑 首先 强制 转换 为 较 小 的 无 符号 
类 型 


编译 器 隐 式 地 拓宽 了 并 带 符号 扩展 了 变量 ， 然 后 在 按 位 "或 "运算 中 使 用 了 结果 值 。 
这 可 能 导致 意外 的 行为 。 


下 面 的 示例 生成 CS0675 : 


// CS0675.cs 

// compile with: /W:3 
using System; 

public class sign 


public static void Main() 


int hi = 1; 
int lo = 1; 
long value = (((long)hi) << 32) | 10; // CS0675 


// try the following line instead 
// long value = (((long)hi) << 32) | ((uint)lo); // correct 
j 
j 


4 — OH 


Compiler Warning (level 3) CS1700 


程序 集 引 用 Assembly Name 无 效 ， 无 法 解析 
此 警告 指示 未 正确 指定 特性 (如 InternalsVisibleToAttribute) 。 
有 关 更 多 信息 ， 请 参见 友 元 程序 集 (C# 和 Visual Basic) 。 
下 面 的 示例 生成 CS1700。 
// CS1700.cs 
// compile with: /target:library 
using System.Runtime.CompilerServices; 


[assembly:InternalsVisibleTo("app2, Retargetable-f")] // CS1700 
[assembly:InternalsVisibleTo("app2")] // OK 


Bac ———————— —— ——— cÁ— (9: IH] 


Compiler Warning (level 4) CS0429 


令 测 到 无 法 访问 的 表达 式 代码 


每 当 无 法 访问 代码 中 某 个 表达 式 的 一 部 分 时 ， 便 会 发 生 此 错误 。 在 下 面 的 示例 中 ， 
条 件 false && myTest() 满足 此 条 件 ， 因 为 myTest() 方法 因 && 运算 符 左边 始终 为 
false 这 一 事实 而 永远 不 会 被 计算 。 只 要 && 运算 符 将 false 语句 计算 为 false， 它 
便 会 停止 计算 ， 并 且 永远 不 会 计算 右边 。 


下 面 的 代码 生成 CS0429。 


// CS0429.cs 
public class cs0429 


public static void Main() 
if (false && myTest()) // CS0429 


// Try the following line instead: 
// if (true && myTest()) 


} 

else 

{ 
int i = 0; 
i++; 

} 


} 


static bool myTest() { return true; } 


Compiler Warning (level 4) CS1591 


缺少 对 公共 可 见 类 型 或 成 员 *Type_or Member 的 XML 注释 
指定 了 /doc 编译 器 选项 ， 但 有 一 个 或 多 个 构造 没有 注释 。 
下 面 的 示例 生成 CS1591 : 


// CS1591.cs 
// compile with: /W:4 /doc:x.xml 


/// text 
public class Test 


// /// text 
public static void Main() // CS1591, remove "//" from previous 





Compiler Warning (level 4) CS1610 


无 法 删除 用 于 默认 Win32 资源 的 临时 文件 “file”-- resource 

在 使 用 /win32res 编译 器 选项 时 以 及 当 %TEMP% 目录 没有 DELETE 权限 时 ， 该 警 
告 指 示 编 译 器 未 能 删除 它 创 建 的 临时 文件 。 

确保 对 %TEMP% 目录 有 读 / 写 /删除 权限 。 

如 有 必要 ， 可 以 手动 删除 这 些 文件 ， 这 对 CH 或 您 的 任何 程序 没有 损害 。 


pom E 
C# 4 SASL 
CH 语言 规范 是 CH 语法 和 用 法 的 权威 来 源 。 此 规范 包含 有 关 语 言 所 有 方面 的 详细 信 
息 ， 包 括 Visual C# 的 文档 中 并 未 涵盖 的 许多 要 点 。 
可 以 从 Microsoft 下 载 中 心 下载 此 规范 。 如 果 已 安装 Visual Studio 2013， 则 你 还 可 
以 在 计算 机 上 的 Program Files (x86)/Microsoft Visual Studio 


12.0/VC#/Specifications/1033 文件 夹 中 查找 此 规范 。 但 Visual Studio Express 
2013 的 安装 不 包含 此 文件 。 


请 参阅 
CH 参考 
C# 编程 指南 


